about summary refs log tree commit diff
diff options
context:
space:
mode:
-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>)(