postgres.git / summary / log / commit / refs

commit    148326b9940c6f3aa554df83a70c7d4563f67d86
Author:   Alvaro Herrera <alvherre@alvh.no-ip.org>
Date:     Tue Jul 02 16:21:16 2013 +0000
First released in: 9.4.0, 8.4.18, 9.0.14, 9.1.10, 9.2.5, 9.3.0

    Mention extra_float_digits in floating point docs
    
    Make it easier for readers of the FP docs to find out about possibly
    truncated values.
    
    Per complaint from Tom Duffey in message
    F0E0F874-C86F-48D1-AA2A-0C5365BF5118@trillitech.com
    
    Author: Albe Laurenz
    Reviewed by: Abhijit Menon-Sen


 doc/src/sgml/config.sgml   |  1 +
 doc/src/sgml/datatype.sgml | 11 +++++++++++
 2 files changed, 12 insertions(+)

diff --git a/doc/src/sgml/config.sgml b/doc/src/sgml/config.sgml
index 940ed6ef58b..437dbb7711c 100644
--- a/doc/src/sgml/config.sgml
+++ b/doc/src/sgml/config.sgml
@@ -5366,6 +5366,7 @@ SET XML OPTION { DOCUMENT | CONTENT };
         partially-significant digits; this is especially useful for dumping
         float data that needs to be restored exactly.  Or it can be set
         negative to suppress unwanted digits.
+        See also <xref linkend="datatype-float">.
        </para>
       </listitem>
      </varlistentry>
diff --git a/doc/src/sgml/datatype.sgml b/doc/src/sgml/datatype.sgml
index f73e6b2e3a5..87668ea0c1c 100644
--- a/doc/src/sgml/datatype.sgml
+++ b/doc/src/sgml/datatype.sgml
@@ -681,6 +681,17 @@ NUMERIC
      from zero will cause an underflow error.
     </para>
 
+    <note>
+     <para>
+      The <xref linkend="guc-extra-float-digits"> setting controls the
+      number of extra significant digits included when a floating point
+      value is converted to text for output.  With the default value of
+      <literal>0</literal>, the output is the same on every platform
+      supported by PostgreSQL.  Increasing it will produce output that
+      more accurately represents the stored value, but may be unportable.
+     </para>
+    </note>
+
     <indexterm>
      <primary>not a number</primary>
      <secondary>double precision</secondary>


[parent: d2e71ff7573e]