bug-gnulib
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

getdate.texi sync from coreutils


From: Paul Eggert
Subject: getdate.texi sync from coreutils
Date: Mon, 09 Jan 2006 15:15:06 -0800
User-agent: Gnus/5.1007 (Gnus v5.10.7) Emacs/21.4 (gnu/linux)

I installed this:

2006-01-09  Paul Eggert  <address@hidden>

        * doc/getdate.texi (General date syntax): Invalid dates are rejected.
        (Time of day items): Mention the possibility of leap seconds.
        Problem reported by Dr. David Alan Gilbert.

Index: doc/getdate.texi
===================================================================
RCS file: /cvsroot/gnulib/gnulib/doc/getdate.texi,v
retrieving revision 1.4
diff -p -u -r1.4 getdate.texi
--- doc/getdate.texi    11 May 2005 20:26:49 -0000      1.4
+++ doc/getdate.texi    9 Jan 2006 23:02:06 -0000
@@ -1,7 +1,7 @@
 @c GNU date syntax documentation
 
 @c Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002,
address@hidden 2003, 2004, 2005 Free Software Foundation, Inc.
address@hidden 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
 
 @c Permission is granted to copy, distribute and/or modify this document
 @c under the terms of the GNU Free Documentation License, Version 1.1 or
@@ -144,6 +144,11 @@ between round parentheses, as long as in
 nested.  Hyphens not followed by a digit are currently ignored.  Leading
 zeros on numbers are ignored.
 
+Invalid dates like @samp{2005-02-29} or times like @samp{24:00} are
+rejected.  In the typical case of a host that does not support leap
+seconds, a time like @samp{23:59:60} is rejected even if it
+corresponds to a valid leap second.
+
 
 @node Calendar date items
 @section Calendar date items
@@ -238,7 +243,8 @@ a number between 0 and 23, @var{minute} 
 @samp{.} or @samp{,} and a fraction containing one or more digits.
 Alternatively,
 @samp{:@var{second}} can be omitted, in which case it is taken to
-be zero.
+be zero.  On the rare hosts that support leap seconds, @var{second}
+may be 60.
 
 @findex am @r{in date strings}
 @findex pm @r{in date strings}
@@ -464,8 +470,8 @@ integers and can represent times from 19
 of seconds with nanosecond subcounts, and can represent all the times
 in the known lifetime of the universe to a resolution of 1 nanosecond.
 
-On most systems, these counts ignore the presence of leap seconds.
-For example, on most systems @samp{@@915148799} represents 1998-12-31
+On most hosts, these counts ignore the presence of leap seconds.
+For example, on most hosts @samp{@@915148799} represents 1998-12-31
 23:59:59 @sc{utc}, @samp{@@915148800} represents 1999-01-01 00:00:00
 @sc{utc}, and there is no way to represent the intervening leap second
 1998-12-31 23:59:60 @sc{utc}.




reply via email to

[Prev in Thread] Current Thread [Next in Thread]