about summary refs log tree commit diff
diff options
context:
space:
mode:
authorClint Adams <clint@users.sourceforge.net>2002-02-21 13:43:00 +0000
committerClint Adams <clint@users.sourceforge.net>2002-02-21 13:43:00 +0000
commitd1f65a53bbc55d9f005db9757ec200bdb29fbd69 (patch)
treeb5b8b8b42f6fc03abf3434fe44c19cad440799dd
parentf2da4d4ed816ee0cb1a397be4fc946fcbc464972 (diff)
downloadzsh-d1f65a53bbc55d9f005db9757ec200bdb29fbd69.tar.gz
zsh-d1f65a53bbc55d9f005db9757ec200bdb29fbd69.tar.xz
zsh-d1f65a53bbc55d9f005db9757ec200bdb29fbd69.zip
16688: clarify the pseudo-randomness of RANDOM.
-rw-r--r--ChangeLog5
-rw-r--r--Doc/Zsh/params.yo7
2 files changed, 11 insertions, 1 deletions
diff --git a/ChangeLog b/ChangeLog
index 86e4bf328..9bd658884 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2002-02-21  Clint Adams  <clint@zsh.org>
+
+	* 16688: Doc/Zsh/params.yo: clarify the pseudo-randomness of
+	RANDOM.
+
 2002-02-20  Bart Schaefer  <schaefer@zsh.org>
 
 	* unposted: Completion/Unix/Command/_pine: Fix sed expression to
diff --git a/Doc/Zsh/params.yo b/Doc/Zsh/params.yo
index fb83863a1..e389a6449 100644
--- a/Doc/Zsh/params.yo
+++ b/Doc/Zsh/params.yo
@@ -574,9 +574,14 @@ and whenever the directory changes.
 )
 vindex(RANDOM)
 item(tt(RANDOM) <S>)(
-A random integer from 0 to 32767, newly generated each time
+A pseudo-random integer from 0 to 32767, newly generated each time
 this parameter is referenced.  The random number generator
 can be seeded by assigning a numeric value to tt(RANDOM).
+
+The values of tt(RANDOM) form an intentionally-repeatable pseudo-random
+sequence; subshells that reference tt(RANDOM) will result
+in identical pseudo-random values unless the value of tt(RANDOM) is
+referenced or seeded in the parent shell in between subshell invocations.
 )
 vindex(SECONDS)
 item(tt(SECONDS) <S>)(