changeset 76854:74d5354ad0c4

(Timers): Fix description of run-at-time TIME formats.
author Glenn Morris <rgm@gnu.org>
date Sat, 31 Mar 2007 23:29:38 +0000
parents 4218ede6f4f2
children e6686c0a3d45
files lispref/os.texi
diffstat 1 files changed, 9 insertions(+), 16 deletions(-) [+]
line wrap: on
line diff
--- a/lispref/os.texi	Sat Mar 31 23:29:29 2007 +0000
+++ b/lispref/os.texi	Sat Mar 31 23:29:38 2007 +0000
@@ -1421,20 +1421,12 @@
 
 @var{time} may specify an absolute or a relative time.
 
-Absolute times may be specified in a wide variety of formats; this
-function tries to accept all the commonly used date formats.  The most
-convenient formats are strings.  Valid such formats include these two,
-
-@example
-@var{year}-@var{month}-@var{day} @var{hour}:@var{min}:@var{sec} @var{timezone}
-
-@var{hour}:@var{min}:@var{sec} @var{timezone} @var{month}/@var{day}/@var{year}
-@end example
-
-@noindent
-where in both examples all fields are numbers; the format that
-@code{current-time-string} returns is also allowed, and many others
-as well.
+Absolute times may be specified using a string with a limited variety of
+formats, and are taken to be times @emph{today}, even if already in the
+past.  The recognized forms are XXXX, X:XX, or XX:XX (military time),
+and XXam, XXAM, XXpm, XXPM, XX:XXam, XX:XXAM XX:XXpm, or XX:XXPM.  A
+period can be used instead of a colon to separate the hour and minute
+parts.
 
 To specify a relative time as a string, use numbers followed by units.
 For example:
@@ -1452,8 +1444,9 @@
 days, and a year to be exactly 365.25 days.
 
 Not all convenient formats are strings.  If @var{time} is a number
-(integer or floating point), that specifies a relative time measured
-in seconds.
+(integer or floating point), that specifies a relative time measured in
+seconds.  The result of @code{encode-time} can also be used to specify
+an absolute value for @var{time}.
 
 In most cases, @var{repeat} has no effect on when @emph{first} call
 takes place---@var{time} alone specifies that.  There is one exception: