Spiff up discussion of precision on date/time data types.

Add a NetBSD/alpha and update info on a few other platforms.

diff --git a/doc/src/sgml/datatype.sgml b/doc/src/sgml/datatype.sgml
index 84b7122820b635a91e300d44395affadec62221c..ae7ac01e7542b0122db7186d69a678ac9d12d5da 100644 (file)
--- a/doc/src/sgml/datatype.sgml
+++ b/doc/src/sgml/datatype.sgml
@@ -1328,21 +1328,20 @@ SELECT b, char_length(b) FROM test2;
 
    <para>
     <type>time</type> and <type>timestamp</type> both accept an
-    option precision field <replaceable>p</replaceable> which
+    optional precision field <replaceable>p</replaceable> which
     determines the number of digits retained beyond the seconds
     decimal point. By default, there is no explicit bound on precision
     and the actual precision is determined by the underlying double
     precision floating point number used to store values in seconds
     for <type>interval</type> and
-    since 2000-01-01 in the case of <type>timestamp</type>.
+    in seconds since 2000-01-01 for <type>timestamp</type>.
    </para>
 
    <para>
     Time zones, and time-zone conventions, are influenced by
-    political decisions, not just physical effects. Time zones have
-    become somewhat standardized around the world during the 1900's,
-    but continue to 
-    be prone to arbitrary changes.
+    political decisions, not just geometry. Time zones around the
+    world became somewhat standardized during the 1900's,
+    but continue to be prone to arbitrary changes.
     <productname>PostgreSQL</productname> uses your operating
     system's underlying features to provide time-zone
     support, and these systems usually contain information for only
@@ -1354,13 +1353,15 @@ SELECT b, char_length(b) FROM test2;
    </para>
 
    <para>
-    To ensure compatibility to earlier versions of <productname>PostgreSQL</productname>
+    To ensure compatibility to earlier versions of
+    <productname>PostgreSQL</productname> 
     we continue to provide <type>datetime</type>
     (equivalent to <type>timestamp</type>) and
     <type>timespan</type> (equivalent to <type>interval</type>),
     however support for these is now restricted to having an
     implicit translation to <type>timestamp</type> and
-    <type>interval</type>.
+    <type>interval</type>, and these name mappings will be removed in
+    the next version.
     The types <type>abstime</type>
     and <type>reltime</type> are lower precision types which are used internally.
     You are discouraged from using any of these types in new
@@ -1376,9 +1377,12 @@ SELECT b, char_length(b) FROM test2;
      Date and time input is accepted in almost any reasonable format, including
      <acronym>ISO 8601</acronym>, <acronym>SQL</acronym>-compatible, 
      traditional <productname>PostgreSQL</productname>, and others.
-     The ordering of month and day in date input can be ambiguous, therefore a setting
-     exists to specify how it should be interpreted in ambiguous cases. The command
-     <literal>SET DateStyle TO 'US'</literal> or <literal>SET DateStyle TO 'NonEuropean'</literal>
+     For some formats, ordering of month and day in date input can be
+     ambiguous and there is support for specifying the expected
+     ordering of these fields.
+     The command
+     <literal>SET DateStyle TO 'US'</literal> 
+     or <literal>SET DateStyle TO 'NonEuropean'</literal>
      specifies the variant <quote>month before day</quote>, the command
      <literal>SET DateStyle TO 'European'</literal> sets the variant
      <quote>day before month</quote>. The <literal>ISO</literal> style
@@ -1386,24 +1390,29 @@ SELECT b, char_length(b) FROM test2;
     </para>
 
     <para>
+     <productname>PostgreSQL</productname> is more flexible in
+     handling date/time than the
+     <acronym>SQL</acronym> standard requires.
      See <xref linkend="datetime-appendix">
-     for the exact parsing rules of date/time input and for the recognized time zones.
+     for the exact parsing rules of date/time input and for the
+     recognized time zones. 
     </para>
 
     <para>
-     Remember that any date or time input needs to be enclosed into
-     single quotes, like text strings.  Refer to <xref
-     linkend="sql-syntax-constants-generic"> for more information.
+     Remember that any date or time literal input needs to be enclosed
+     in single quotes, like text strings.  Refer to 
+     <xref linkend="sql-syntax-constants-generic"> for more
+     information.
      <acronym>SQL9x</acronym> requires the following syntax
 <synopsis>
 <replaceable>type</replaceable> [ (<replaceable>p</replaceable>) ] '<replaceable>value</replaceable>'
 </synopsis>
-     where <replaceable>p</replaceable> is an integer specifying the
-     number of fractional digits in the seconds field, and is allowed
-     for <type>time</type>, <type>timestamp</type>, and <type>interval</type> types.
-     <productname>PostgreSQL</productname> is more flexible in
-     handling date/time than the
-     <acronym>SQL</acronym> standard requires.
+     where <replaceable>p</replaceable> in the optional precision
+     specification is an integer corresponding to the
+     number of fractional digits in the seconds field. Precision can
+     be specified 
+     for <type>time</type>, <type>timestamp</type>, and
+     <type>interval</type> types.
     </para>
 
     <sect3>

diff --git a/doc/src/sgml/installation.sgml b/doc/src/sgml/installation.sgml
index 319697bcbc2f9a0fb44dfa6a5de9ce6a8e8ba839..39fffee955959862e0bfe340a952fd85b50519cd 100644 (file)
--- a/doc/src/sgml/installation.sgml
+++ b/doc/src/sgml/installation.sgml
@@ -1372,9 +1372,10 @@ gunzip -c user.ps.gz \
        <entry><systemitem class="osname">AIX</></entry>
        <entry><systemitem>RS6000</></entry>
        <entry>7.2</entry>
-       <entry>2001-11-28,
-        Andreas Zeugswetter (<email>[email protected]</email>)</entry>
-        <entry>4.3; see also <filename>doc/FAQ_AIX</filename></entry>
+       <entry>2001-12-19,
+        Andreas Zeugswetter (<email>[email protected]</email>),
+        Tatsuo Ishii (<email>[email protected]</email>)</entry>
+        <entry>see also <filename>doc/FAQ_AIX</filename></entry>
        </row>
        <row>
        <entry><systemitem class="osname">BeOS</></entry>
@@ -1392,6 +1393,14 @@ gunzip -c user.ps.gz \
         Bruce Momjian (<email>[email protected]</email>)</entry>
         <entry>4.2</entry>
        </row>
+       <row>
+       <entry><systemitem class="osname">FreeBSD</></entry>
+       <entry><systemitem>Alpha</></entry>
+       <entry>7.2</entry>
+       <entry>2001-12-18,
+        Chris Kings-Lynne (<email>[email protected]</email>)</entry>
+        <entry></entry>
+       </row>
        <row>
        <entry><systemitem class="osname">FreeBSD</></entry>
        <entry><systemitem>x86</></entry>
@@ -1428,9 +1437,9 @@ gunzip -c user.ps.gz \
        <row>
        <entry><systemitem class="osname">Linux</></entry>
        <entry><systemitem>armv4l</></entry>
-       <entry>7.1</entry>
-       <entry>2001-02-22,
-        Mark Knox (<email>[email protected]</email>)</entry>
+       <entry>7.2</entry>
+       <entry>2001-12-10,
+        Mark Knox (<email>[email protected]</email>)</entry>
        <entry>2.2.x</entry>
        </row>
        <row>
@@ -1441,6 +1450,14 @@ gunzip -c user.ps.gz \
         Hisao Shibuya (<email>[email protected]</>)</entry>
        <entry>2.0.x; <productname>Cobalt Qube2</></entry>
        </row>
+       <row>
+       <entry><systemitem class="osname">Linux</></entry>
+       <entry><systemitem>PlayStation2</></entry>
+       <entry>7.2</entry>
+       <entry>2001-12-12,
+        Permaine Cheung <email>[email protected]</email>)</entry>
+       <entry>#undef HAS_TEST_AND_SET, slock_t</entry>
+       </row>
        <row>
        <entry><systemitem class="osname">Linux</></entry>
        <entry><systemitem>PPC74xx</></entry>
@@ -1452,9 +1469,9 @@ gunzip -c user.ps.gz \
        <row>
        <entry><systemitem class="osname">Linux</></entry>
        <entry><systemitem>S/390</></entry>
-       <entry>7.1</entry>
-       <entry>2000-11-17,
-        Neale Ferguson (<email>Neale.Ferguson@softwareAG-usa.com</email>)</entry>
+       <entry>7.2</entry>
+       <entry>2001-12-12,
+        Permaine Cheung <email>pcheung@redhat.com</email>)</entry>
        <entry></entry>
        </row>
        <row>
@@ -1565,11 +1582,20 @@ gunzip -c user.ps.gz \
      <row>
       <entry><systemitem class="osname">QNX 4.25</></entry>
       <entry><systemitem>x86</></entry>
-      <entry>7.1</entry>
-      <entry>2001-05-24,
+      <entry>7.2</entry>
+      <entry>2001-12-10,
        Bernd Tegge (<email>[email protected]</email>)
       </entry>
       <entry>see also <filename>doc/FAQ_QNX4</filename></entry>
+     </row>
+     <row>
+      <entry><systemitem class="osname">QNX 6</></entry>
+      <entry><systemitem>x86</></entry>
+      <entry>7.2</entry>
+      <entry>2001-12-10,
+       Igor Kovalenko (<email>[email protected]</email>)
+      </entry>
+      <entry>Requires patches for Posix semaphores; see archives</entry>
      </row>
        <row>
        <entry><systemitem class="osname">Solaris</></entry>
@@ -1587,22 +1613,43 @@ gunzip -c user.ps.gz \
         Martin Renters (<email>[email protected]</email>)</entry>
        <entry>2.8; see also <filename>doc/FAQ_Solaris</filename></entry>
        </row>
+      <row>
+       <entry><systemitem class="osname">SunOS</></entry>
+       <entry><systemitem>Sparc</></entry>
+       <entry>7.2</entry>
+       <entry>2001-12-04, Tatsuo Ishii (<email>[email protected]</email>)</entry>
+       <entry></entry>
+      </row>
        <row>
        <entry><systemitem class="osname">Tru64 UNIX</></entry>
        <entry><systemitem>Alpha</></entry>
        <entry>7.2</entry>
        <entry>2001-11-26,
-        Alessio Bragadini (<email>[email protected]</email>)</entry>
-        <entry>4.0g, with cc and gcc</entry>
+        Alessio Bragadini (<email>[email protected]</email>),
+         Bernd Tegge (<email>[email protected]</email>)</entry>
+        <entry>5.0; 4.0g with cc and gcc</entry>
        </row>
        <row>
-       <entry><systemitem class="osname">Windows NT/2000</></entry>
+       <entry><systemitem class="osname">Windows</></entry>
        <entry><systemitem>x86</></entry>
-       <entry>7.1</entry>
-       <entry>2001-03-16,
+       <entry>7.2</entry>
+       <entry>2001-12-13,
+        Dave Page (<email>[email protected]</email>),
         Jason Tishler (<email>[email protected]</email>)</entry>
-        <entry>with <application>Cygwin</application> tool set, see <filename>doc/FAQ_MSWIN</filename></entry>
+        <entry>with <application>Cygwin</application>; see <filename>doc/FAQ_MSWIN</filename></entry>
        </row>
+      <row>
+       <entry><systemitem class="osname">Windows</></entry>
+       <entry><systemitem>x86</></entry>
+       <entry>7.2</entry>
+       <entry>2001-12-10,
+       Dave Page (<email>[email protected]</email>)</entry>
+       <entry>
+       native is client-side only;
+<![%standalone-include[see Administrator's Guide]]>
+<![%standalone-ignore[see <xref linkend="install-win32">]]>
+       </entry>
+      </row>
       </tbody>
      </tgroup>
     </informaltable>
@@ -1668,14 +1715,7 @@ Obsolete platform? This distro was merged into PPC afaik. - thomas 2001-12-07
       <entry><systemitem>x86</></entry>
       <entry>6.5</entry>
       <entry>1999-05-25, Andrew Merrill (<email>[email protected]</>)</entry>
-      <entry>7.2 should work, but no reports; see also <filename>doc/FAQ_SCO</filename></entry>
-     </row>
-     <row>
-      <entry><systemitem class="osname">SunOS</></entry>
-      <entry><systemitem>Sparc</></entry>
-      <entry>7.2</entry>
-      <entry>2001-12-04, Tatsuo Ishii (<email>[email protected]</email>)</entry>
-      <entry><function>memcmp()</> does not work correctly, so probably not reliable</entry>
+      <entry>&version; should work, but no reports; see also <filename>doc/FAQ_SCO</filename></entry>
      </row>
      <row>
       <entry><systemitem class="osname">System V R4</></entry>
@@ -1703,24 +1743,11 @@ Obsolete platform? This distro was merged into PPC afaik. - thomas 2001-12-07
       <entry><systemitem>VAX</></entry>
       <entry>6.x</entry>
       <entry>1998-03-01</entry>
-      <entry>no recent reports</entry>
-     </row>
-     <row>
-      <entry><systemitem class="osname">Windows 9x, ME, NT, 2000</> (native)</entry>
-      <entry><systemitem>x86</></entry>
-      <entry>7.1</entry>
-      <entry>2001-03-26, Magnus Hagander (<email>[email protected]</email>)</entry>
-      <entry>
-       client-side libraries (<application>libpq</> and <application>psql</>) or ODBC or JDBC, no server-side;
-<![%standalone-include[see <citetitle>Administrator's Guide</>]]>
-<![%standalone-ignore[see <xref linkend="install-win32">]]>
-       for instructions
-      </entry>
+      <entry></entry>
      </row>
     </tbody>
    </tgroup>
   </informaltable>
-
  </sect1>
 
 </chapter>