Doc: improve documentation about random().
authorTom Lane <tgl@sss.pgh.pa.us>
Sat, 23 Jul 2022 23:00:29 +0000 (19:00 -0400)
committerTom Lane <tgl@sss.pgh.pa.us>
Sat, 23 Jul 2022 23:00:33 +0000 (19:00 -0400)
commit6955bba0ede45e9379d04d7faaa889448919aa07
treea29d22acc65431de0d98d7b2cc5e70dd1a0672ff
parente757cdd6ad1bc757df7a73616bde8d7e1cb2828a
Doc: improve documentation about random().

We didn't explicitly say that random() uses a randomly-chosen seed
if you haven't called setseed().  Do so.

Also, remove ref/set.sgml's no-longer-accurate (and never very
relevant) statement that the seed value is multiplied by 2^31-1.

Back-patch to v12 where set.sgml's claim stopped being true.
The claim that we use a source of random bits as seed was debatable
before 4203842a1, too, so v12 seems like a good place to stop.

Per question from Carl Sopchak.

Discussion: https://postgr.es/m/f37bb937-9d99-08f0-4de7-80c91a3cfc2e@sopchak.me
doc/src/sgml/func.sgml
doc/src/sgml/ref/set.sgml