summaryrefslogtreecommitdiff
path: root/libiberty/random.c
diff options
context:
space:
mode:
authorDJ Delorie <dj@redhat.com>2001-10-15 22:50:13 -0400
committerDJ Delorie <dj@gcc.gnu.org>2001-10-15 22:50:13 -0400
commitaac04c15d761628889f138b16219bce27f25bbb2 (patch)
tree58903ff3e4335306b7c9f5c24e8baf3b9a9922a8 /libiberty/random.c
parent2d4368e6cd739fadc7e3cc1111f30f2941e8a8a3 (diff)
downloadgcc-aac04c15d761628889f138b16219bce27f25bbb2.tar.gz
Makefile.in (TEXIFILES): Add fnmatch.txh.
* Makefile.in (TEXIFILES): Add fnmatch.txh. (maint-undoc): New. maint-tool: Add "undoc" tool. * alloca.c, argv.c, asprintf.c, choose-temp.c, concat.c, fdmatch.c, ffs.c, getruntime.c, insque.c, lbasename.c, make-temp-file.c, mkstemps.c, pexecute.c, random.c, spaces.c, strerror.s, strsignal.c, strtol.c, vasprintf.c: Add or update documentation. * fnmatch.txh: New. * functions.texi: Regenerate. From-SVN: r46274
Diffstat (limited to 'libiberty/random.c')
-rw-r--r--libiberty/random.c18
1 files changed, 18 insertions, 0 deletions
diff --git a/libiberty/random.c b/libiberty/random.c
index ef00da0a5ae..7c46bac6448 100644
--- a/libiberty/random.c
+++ b/libiberty/random.c
@@ -34,6 +34,24 @@
* It was reworked for the GNU C Library by Roland McGrath.
*/
+/*
+
+@deftypefn Supplement {long int} random ()
+@deftypefnx Supplement void srandom (unsigned int @var{seed})
+@deftypefnx Supplement void* initstate (unsigned int @var{seed}, void *@var{arg_state}, unsigned long @var{n})
+@deftypefnx Supplement void* setstate (void *@var{arg_state})
+
+Random number functions. @code{random} returns a random number in the
+range @code{0..LONG_MAX}. @code{srandom} initializes the random
+number generator to some starting point determined by @var{seed}
+(else, the values returned by @code{random} are always the same for each
+run of the program). @code{initstate} and @code{setstate} allow fine-grain
+control over the state of the random number generator.
+
+@end deftypefn
+
+*/
+
#include <errno.h>
#if 0