Re: random() function documentation - Mailing list pgsql-hackers

From Dagfinn Ilmari Mannsåker
Subject Re: random() function documentation
Date
Msg-id 8735ijphrp.fsf@wibble.ilmari.org
Whole thread Raw
In response to Re: random() function documentation  (Tom Lane <tgl@sss.pgh.pa.us>)
Responses Re: random() function documentation  (Tom Lane <tgl@sss.pgh.pa.us>)
List pgsql-hackers
Tom Lane <tgl@sss.pgh.pa.us> writes:

> =?utf-8?Q?Dagfinn_Ilmari_Manns=C3=A5ker?= <ilmari@ilmari.org> writes:
>> I just noticed that the since the random() rewrite¹, the documentation's
>> claim² that it "uses a simple linear congruential algorithm" is no
>> longer accurate (xoroshiro128** is an xorshift variant, which is a
>> linear-feedback shift register algorithm).
>
>> I don't have a suggestion for the exact wording, since I don't know
>> whether xoroshiro128** qualifies as "simple", or to what level of
>> specificity we want to document the algorithm.
>
> How about we just say "uses a linear-feedback shift register algorithm"?

That works for me.  Nice and simple, and not overly specific.  Should we
perhaps also add a warning that the same seed is not guaranteed to
produce the same sequence across different (major?) versions?

> "Simple" is in the eye of the beholder anyway.

Indeed.

>             regards, tom lane

- ilmari



pgsql-hackers by date:

Previous
From: Thom Brown
Date:
Subject: Re: [COMMITTERS] pgsql: Allow time delayed standbys and recovery
Next
From: Tom Lane
Date:
Subject: Re: How about a psql backslash command to show GUCs?