From 53e7229258cb6463cffa70c9be20b9630aed8940 Mon Sep 17 00:00:00 2001
From: Tom Lane <tgl@sss.pgh.pa.us>
Date: Wed, 8 Jul 2009 17:21:55 +0000
Subject: [PATCH] Add missing HOUR TO SECOND option to list of possible
 INTERVAL field sets, as noted by Sebastien Flaesch.  Also update the claim
 that we simply throw away fields outside this set --- that got changed later
 to only discard less-significant fields.

---
 doc/src/sgml/datatype.sgml | 16 ++++++++++------
 1 file changed, 10 insertions(+), 6 deletions(-)

diff --git a/doc/src/sgml/datatype.sgml b/doc/src/sgml/datatype.sgml
index 763a114e7f..774e4dbfb0 100644
--- a/doc/src/sgml/datatype.sgml
+++ b/doc/src/sgml/datatype.sgml
@@ -1,4 +1,4 @@
-<!-- $PostgreSQL: pgsql/doc/src/sgml/datatype.sgml,v 1.239 2009/06/17 21:58:49 tgl Exp $ -->
+<!-- $PostgreSQL: pgsql/doc/src/sgml/datatype.sgml,v 1.240 2009/07/08 17:21:55 tgl Exp $ -->
 
  <chapter id="datatype">
   <title id="datatype-title">Data Types</title>
@@ -1524,11 +1524,11 @@ SELECT b, char_length(b) FROM test2;
     DAY TO MINUTE
     DAY TO SECOND
     HOUR TO MINUTE
+    HOUR TO SECOND
     MINUTE TO SECOND
 </programlisting>
-    Input falling outside the specified set of fields is silently discarded.
     Note that if both <replaceable>fields</replaceable> and
-    <replaceable>precision</replaceable> are specified, the
+    <replaceable>p</replaceable> are specified, the
     <replaceable>fields</replaceable> must include <literal>SECOND</>,
     since the precision applies only to the seconds.
    </para>
@@ -2468,11 +2468,15 @@ P <optional> <replaceable>years</>-<replaceable>months</>-<replaceable>days</> <
 
     <para>
      When writing an interval constant with a <replaceable>fields</>
-     specification, or when assigning to an interval column that was defined
-     with a <replaceable>fields</> specification, the interpretation of
+     specification, or when assigning a string to an interval column that was
+     defined with a <replaceable>fields</> specification, the interpretation of
      unmarked quantities depends on the <replaceable>fields</>.  For
      example <literal>INTERVAL '1' YEAR</> is read as 1 year, whereas
-     <literal>INTERVAL '1'</> means 1 second.
+     <literal>INTERVAL '1'</> means 1 second.  Also, field values
+     <quote>to the right</> of the least significant field allowed by the
+     <replaceable>fields</> specification are silently discarded.  For
+     example, writing <literal>INTERVAL '1 day 2:03:04' HOUR TO MINUTE</>
+     results in dropping the seconds field, but not the day field.
     </para>
 
     <para>