docs for random function - Mailing list pgsql-hackers

From Sam Mason
Subject docs for random function
Date
Msg-id 20090816123503.GX5407@samason.me.uk
Whole thread Raw
Responses Re: docs for random function  (Tom Lane <tgl@sss.pgh.pa.us>)
List pgsql-hackers
Hi,

The docs for the function random() currently say:
 random value between 0.0 and 1.0, inclusive

this isn't a particularly useful invariant, what the code actually does
(and is commented as doing) is much more useful.  Any chance of changing
it to something like:

--- doc/src/sgml/func.sgml~     2009-06-17 22:58:49.000000000 +0100
+++ doc/src/sgml/func.sgml      2009-08-16 13:28:18.814767110 +0100
@@ -821,7 +821,7 @@      <row>       <entry><literal><function>random</function>()</literal></entry>
<entry><type>dp</type></entry>
-       <entry>random value between 0.0 and 1.0, inclusive</entry>
+       <entry>random value in the range [0.0 - 1.0)</entry>       <entry><literal>random()</literal></entry>
<entry></entry>     </row>
 

or maybe something more readable to non-maths people?

--  Sam  http://samason.me.uk/


pgsql-hackers by date:

Previous
From: Peter Eisentraut
Date:
Subject: Re: freezing tuples ( was: Why is vacuum_freeze_min_age 100m? )
Next
From: Pierre Frédéric Caillaud
Date:
Subject: Re: [PATCH] plpythonu datatype conversion improvements