NotificationsYou must be signed in to change notification settings
Fork6
Star31

Commitbd6cfbf

committed

Doc: improve documentation about random().

We didn't explicitly say that random() uses a randomly-chosen seedif you haven't called setseed(). Do so.Also, remove ref/set.sgml's no-longer-accurate (and never veryrelevant) 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 debatablebefore4203842, 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

1 parent44d0e41 commitbd6cfbfCopy full SHA for bd6cfbf

File tree

2 files changed

-2

lines changed

doc/src/sgml
- func.sgml
- ref
  - set.sgml

2 files changed

-2

lines changed

`‎doc/src/sgml/func.sgml`

Lines changed: 3 additions & 0 deletions

Original file line number	Diff line number	Diff line change
`@@ -1841,6 +1841,9 @@ repeat('Pg', 4) <returnvalue>PgPgPgPg</returnvalue>`
`1841`	`1841`	`subsequent <function>random()</function> calls in the current session`
`1842`	`1842`	`can be repeated by re-issuing <function>setseed()</function> with the same`
`1843`	`1843`	`argument.`
	`1844`	`+ Without any prior <function>setseed()</function> call in the same`
	`1845`	`+ session, the first <function>random()</function> call obtains a seed`
	`1846`	`+ from a platform-dependent source of random bits.`
`1844`	`1847`	`</para>`
`1845`	`1848`
`1846`	`1849`	`<para>`

`‎doc/src/sgml/ref/set.sgml`

Lines changed: 1 addition & 2 deletions

Original file line number	Diff line number	Diff line change
`@@ -177,8 +177,7 @@ SET [ SESSION \| LOCAL ] TIME ZONE { <replaceable class="parameter">timezone</rep`
`177`	`177`	`<para>`
`178`	`178`	`Sets the internal seed for the random number generator (the`
`179`	`179`	`function <function>random</function>). Allowed values are`
`180`		`- floating-point numbers between -1 and 1, which are then`
`181`		`- multiplied by 2<superscript>31</superscript>-1.`
	`180`	`+ floating-point numbers between -1 and 1 inclusive.`
`182`	`181`	`</para>`
`183`	`182`
`184`	`183`	`<para>`

0 commit comments

Comments

(0)

Movatterモバイル変換

Navigation Menu

Search code, repositories, users, issues, pull requests...

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Commitbd6cfbf

File tree

2 files changed

2 files changed

`‎doc/src/sgml/func.sgml`

`‎doc/src/sgml/ref/set.sgml`

0 commit comments