Clarify documentation of age() functions.

diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml
index f9e5b9384832ce4d289db5e813be7763a12eef42..4eddc2cd9077a79f121f7e003db614a171726433 100644 (file)
--- a/doc/src/sgml/func.sgml
+++ b/doc/src/sgml/func.sgml
@@ -4877,19 +4877,20 @@ substring('foobar' from 'o(.)b')   <lineannotation>o</lineannotation>
 
       <tbody>
        <row>
-       <entry><literal><function>age</function>(<type>timestamp</type>)</literal></entry>
+       <entry><literal><function>age</function>(<type>timestamp</type>, <type>timestamp</type>)</literal></entry>
        <entry><type>interval</type></entry>
-       <entry>Subtract from today</entry>
-       <entry><literal>age(timestamp '1957-06-13')</literal></entry>
-       <entry><literal>43 years 8 mons 3 days</literal></entry>
+       <entry>Subtract arguments, producing a <quote>symbolic</> result that
+       uses years and months</entry>
+       <entry><literal>age(timestamp '2001-04-10', timestamp '1957-06-13')</literal></entry>
+       <entry><literal>43 years 9 mons 27 days</literal></entry>
        </row>
 
        <row>
-       <entry><literal><function>age</function>(<type>timestamp</type>, <type>timestamp</type>)</literal></entry>
+       <entry><literal><function>age</function>(<type>timestamp</type>)</literal></entry>
        <entry><type>interval</type></entry>
-       <entry>Subtract arguments</entry>
-       <entry><literal>age('2001-04-10', timestamp '1957-06-13')</literal></entry>
-       <entry><literal>43 years 9 mons 27 days</literal></entry>
+       <entry>Subtract from <function>current_date</function></entry>
+       <entry><literal>age(timestamp '1957-06-13')</literal></entry>
+       <entry><literal>43 years 8 mons 3 days</literal></entry>
        </row>
 
        <row>