diff options
| author | Paul Eggert | 2018-08-18 15:39:05 -0700 |
|---|---|---|
| committer | Paul Eggert | 2018-08-18 15:42:00 -0700 |
| commit | 97d273033b523bc07911c848d4e8bf96cdce0c90 (patch) | |
| tree | 1def37fdbac9d108c5930a15d1538982f40b52a7 /src | |
| parent | 673b1785db4604efe81b8045a9d8ab68936af719 (diff) | |
| download | emacs-97d273033b523bc07911c848d4e8bf96cdce0c90.tar.gz emacs-97d273033b523bc07911c848d4e8bf96cdce0c90.zip | |
Document that ‘random’ is limited to fixnums
Problem reported by Pip Cet (Bug#32463#20).
* doc/lispref/numbers.texi (Random Numbers):
* src/fns.c (Frandom): Adjust doc.
Diffstat (limited to 'src')
| -rw-r--r-- | src/fns.c | 9 |
1 files changed, 3 insertions, 6 deletions
| @@ -56,15 +56,12 @@ DEFUN ("identity", Fidentity, Sidentity, 1, 1, 0, | |||
| 56 | } | 56 | } |
| 57 | 57 | ||
| 58 | DEFUN ("random", Frandom, Srandom, 0, 1, 0, | 58 | DEFUN ("random", Frandom, Srandom, 0, 1, 0, |
| 59 | doc: /* Return a pseudo-random number. | 59 | doc: /* Return a pseudo-random integer. |
| 60 | All integers representable in Lisp, i.e. between `most-negative-fixnum' | 60 | By default, return a fixnum; all fixnums are equally likely. |
| 61 | and `most-positive-fixnum', inclusive, are equally likely. | 61 | With positive fixnum LIMIT, return random integer in interval [0,LIMIT). |
| 62 | |||
| 63 | With positive integer LIMIT, return random number in interval [0,LIMIT). | ||
| 64 | With argument t, set the random number seed from the system's entropy | 62 | With argument t, set the random number seed from the system's entropy |
| 65 | pool if available, otherwise from less-random volatile data such as the time. | 63 | pool if available, otherwise from less-random volatile data such as the time. |
| 66 | With a string argument, set the seed based on the string's contents. | 64 | With a string argument, set the seed based on the string's contents. |
| 67 | Other values of LIMIT are ignored. | ||
| 68 | 65 | ||
| 69 | See Info node `(elisp)Random Numbers' for more details. */) | 66 | See Info node `(elisp)Random Numbers' for more details. */) |
| 70 | (Lisp_Object limit) | 67 | (Lisp_Object limit) |