Zsh Mailing List Archive Messages sorted by: Reverse Date, Date, Thread, Author

Re: [PATCH] mention zsh/random in the description of $RANDOM

X-seq: zsh-workers 53964
From: Clinton Bunch <cdb_zsh@xxxxxxxxxxx>
To: zsh-workers@xxxxxxx
Subject: Re: [PATCH] mention zsh/random in the description of $RANDOM
Date: Mon, 22 Sep 2025 07:54:10 -0500
Archived-at: <https://zsh.org/workers/53964>
In-reply-to: <ED48F65E-543D-4EAD-8224-DB38134BEA66@kba.biglobe.ne.jp>
List-id: <zsh-workers.zsh.org>
References: <ED48F65E-543D-4EAD-8224-DB38134BEA66@kba.biglobe.ne.jp>

On 9/22/2025 00:04, Jun T wrote:

Following the recent discussion in zsh-users, I think it would
be better to mention zsh/random module in the description of
the variable RANDOM in zshparam(1).

Any comments?

Sounds good to me :), but it might be useful at that point to mentionthe SRANDOM param it provides



diff --git a/Doc/Zsh/params.yo b/Doc/Zsh/params.yo
index dd4519622..5d0fa9555 100644
--- a/Doc/Zsh/params.yo
+++ b/Doc/Zsh/params.yo
@@ -926,6 +926,12 @@ 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.
+
+tt(RANDOM) uses the system's library function tt(rand+LPAR()3+RPAR()).
+You may use

tt(SRANDOM) from

+ifzman(the zsh/random module (see zmanref(zshmodules)))\
+ifnzman(noderef(The zsh/random Module))
+if higher degree of randomness is required.
  )
  vindex(SECONDS)
  item(tt(SECONDS) <S>)(

References:
- [PATCH] mention zsh/random in the description of $RANDOM
  - From: Jun T

Messages sorted by: Reverse Date, Date, Thread, Author