Clarify documentation of age() functions.

diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml
index 111000086d85be940c7358eb3867c4dcc62c3335..52bd7293ca021b3a88a70293baff9be25925033d 100644 (file)
--- a/doc/src/sgml/func.sgml
+++ b/doc/src/sgml/func.sgml
@@ -1,5 +1,5 @@
 
 
@@ -4877,19 +4877,20 @@ substring('foobar' from 'o(.)b')   o
 
       
        
-   age(timestamp)
+   age(timestamp, timestamp)
    interval
-   Subtract from today
-   age(timestamp '1957-06-13')
-   43 years 8 mons 3 days
+   Subtract arguments, producing a symbolic result that
+   uses years and months
+   age(timestamp '2001-04-10', timestamp '1957-06-13')
+   43 years 9 mons 27 days
        
 
        
-   age(timestamp, timestamp)
+   age(timestamp)
    interval
-   Subtract arguments
-   age('2001-04-10', timestamp '1957-06-13')
-   43 years 9 mons 27 days
+   Subtract from current_date
+   age(timestamp '1957-06-13')
+   43 years 8 mons 3 days