diff --git a/functions/datetime.xml b/functions/datetime.xml
index 160d6752c8..04f88a686b 100644
--- a/functions/datetime.xml
+++ b/functions/datetime.xml
@@ -350,8 +350,14 @@ echo gmstrftime ("%b %d %Y %H:%M:%S",mktime(20,0,0,12,31,98))."\n";
 echo date( "M-d-Y", mktime(0,0,0,12,32,1997) );
 echo date( "M-d-Y", mktime(0,0,0,13,1,1997) );
 echo date( "M-d-Y", mktime(0,0,0,1,1,1998) );
+echo date( "M-d-Y", mktime(0,0,0,1,1,98) );
       </programlisting>
      </example>
+     <parameter>year</parameter> may be a two or four digit value, with 
+     values between 0-69 mapping to 2000-2069 and 70-99 to 1970-1999 
+     (on systems where time_t is a 32bit signed integer, as most common
+      today, the valid range for <parameter>year</parameter> is somewhere
+      between 1902 and 2037).
     </para>
     <para>
      The last day of any given month can be expressed as the "0" day