pg.ddx.io  pgsql-committers@postgresql.org mailing list archive  
help / color / mirror / Atom feed
pgsql: Doc: improve documentation about random().
5+ messages / 1 participants
[nested] [flat]

* pgsql: Doc: improve documentation about random().
@ 2022-07-23 23:00  Tom Lane <tgl@sss.pgh.pa.us>
  0 siblings, 0 replies; 5+ messages in thread

From: Tom Lane @ 2022-07-23 23:00 UTC (permalink / raw)
  To: pgsql-committers@lists.postgresql.org

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

Branch
------
REL_12_STABLE

Details
-------
https://git.postgresql.org/pg/commitdiff/042554d55d8539ea621ecf25d10d8c38ff1a2324

Modified Files
--------------
doc/src/sgml/func.sgml    | 3 +++
doc/src/sgml/ref/set.sgml | 3 +--
2 files changed, 4 insertions(+), 2 deletions(-)



^ permalink  raw  reply  [nested|flat] 5+ messages in thread

* pgsql: Doc: improve documentation about random().
@ 2022-07-23 23:00  Tom Lane <tgl@sss.pgh.pa.us>
  0 siblings, 0 replies; 5+ messages in thread

From: Tom Lane @ 2022-07-23 23:00 UTC (permalink / raw)
  To: pgsql-committers@lists.postgresql.org

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

Branch
------
REL_13_STABLE

Details
-------
https://git.postgresql.org/pg/commitdiff/4c9e5162f56d2e9d8e690000a046ff4f59e2268d

Modified Files
--------------
doc/src/sgml/func.sgml    | 3 +++
doc/src/sgml/ref/set.sgml | 3 +--
2 files changed, 4 insertions(+), 2 deletions(-)



^ permalink  raw  reply  [nested|flat] 5+ messages in thread

* pgsql: Doc: improve documentation about random().
@ 2022-07-23 23:00  Tom Lane <tgl@sss.pgh.pa.us>
  0 siblings, 0 replies; 5+ messages in thread

From: Tom Lane @ 2022-07-23 23:00 UTC (permalink / raw)
  To: pgsql-committers@lists.postgresql.org

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

Branch
------
REL_14_STABLE

Details
-------
https://git.postgresql.org/pg/commitdiff/31d5354cb148c6aa90014f62d3a4752adeebd51a

Modified Files
--------------
doc/src/sgml/func.sgml    | 3 +++
doc/src/sgml/ref/set.sgml | 3 +--
2 files changed, 4 insertions(+), 2 deletions(-)



^ permalink  raw  reply  [nested|flat] 5+ messages in thread

* pgsql: Doc: improve documentation about random().
@ 2022-07-23 23:00  Tom Lane <tgl@sss.pgh.pa.us>
  0 siblings, 0 replies; 5+ messages in thread

From: Tom Lane @ 2022-07-23 23:00 UTC (permalink / raw)
  To: pgsql-committers@lists.postgresql.org

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

Branch
------
REL_15_STABLE

Details
-------
https://git.postgresql.org/pg/commitdiff/bd6cfbf338e5c3d65b9271f632142716d67d7c34

Modified Files
--------------
doc/src/sgml/func.sgml    | 3 +++
doc/src/sgml/ref/set.sgml | 3 +--
2 files changed, 4 insertions(+), 2 deletions(-)



^ permalink  raw  reply  [nested|flat] 5+ messages in thread

* pgsql: Doc: improve documentation about random().
@ 2022-07-23 23:00  Tom Lane <tgl@sss.pgh.pa.us>
  0 siblings, 0 replies; 5+ messages in thread

From: Tom Lane @ 2022-07-23 23:00 UTC (permalink / raw)
  To: pgsql-committers@lists.postgresql.org

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

Branch
------
master

Details
-------
https://git.postgresql.org/pg/commitdiff/6955bba0ede45e9379d04d7faaa889448919aa07

Modified Files
--------------
doc/src/sgml/func.sgml    | 3 +++
doc/src/sgml/ref/set.sgml | 3 +--
2 files changed, 4 insertions(+), 2 deletions(-)



^ permalink  raw  reply  [nested|flat] 5+ messages in thread


end of thread, other threads:[~2022-07-23 23:00 UTC | newest]

Thread overview: 5+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2022-07-23 23:00 pgsql: Doc: improve documentation about random(). Tom Lane <tgl@sss.pgh.pa.us>
2022-07-23 23:00 pgsql: Doc: improve documentation about random(). Tom Lane <tgl@sss.pgh.pa.us>
2022-07-23 23:00 pgsql: Doc: improve documentation about random(). Tom Lane <tgl@sss.pgh.pa.us>
2022-07-23 23:00 pgsql: Doc: improve documentation about random(). Tom Lane <tgl@sss.pgh.pa.us>
2022-07-23 23:00 pgsql: Doc: improve documentation about random(). Tom Lane <tgl@sss.pgh.pa.us>

This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox