about summary refs log tree commit diff
path: root/Doc/Zsh
diff options
context:
space:
mode:
Diffstat (limited to 'Doc/Zsh')
-rw-r--r--Doc/Zsh/params.yo7
1 files changed, 6 insertions, 1 deletions
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>)(