summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorKevin B Kenny <kennykb@acm.org>2004-12-13 15:51:32 (GMT)
committerKevin B Kenny <kennykb@acm.org>2004-12-13 15:51:32 (GMT)
commit7a8cb9d50b6409dfbfbf8e60bd57f4f77ffec457 (patch)
treebc80b97bd125facb61deca5ff81e1863bf263659
parent4bfb7f47a42094aae82121f240bad43669481e6b (diff)
downloadtcl-7a8cb9d50b6409dfbfbf8e60bd57f4f77ffec457.zip
tcl-7a8cb9d50b6409dfbfbf8e60bd57f4f77ffec457.tar.gz
tcl-7a8cb9d50b6409dfbfbf8e60bd57f4f77ffec457.tar.bz2
Add note to clock.n disclaiming full ISO8601 support
-rw-r--r--ChangeLog6
-rw-r--r--doc/clock.n8
2 files changed, 12 insertions, 2 deletions
diff --git a/ChangeLog b/ChangeLog
index 115c7c2..a2b24f1 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2004-12-13 Kevin B. Kenny <kennykb@acm.org>
+
+ * doc/clock.n: Clarify that the [clock scan] command does not
+ accept the full range of ISO8601 point-in-time formats
+ [Bug 1075433].
+
2004-12-12 Miguel Sofer <msofer@users.sf.net>
* generic/tclVar.c (TclArrayObjCmd - ARRAY_NAMES): leaking an
diff --git a/doc/clock.n b/doc/clock.n
index 3f19644..0c913c9 100644
--- a/doc/clock.n
+++ b/doc/clock.n
@@ -819,11 +819,15 @@ an error may result if these years are used.
\fIISO 8601 point-in-time\fR
An ISO 8601 point-in-time specification, such as \fBCCyymmddThhmmss\fR,
where \fBT\fR is the literal T, "\fBCCyymmdd hhmmss\fR", or
-\fBCCyymmddThh:mm:ss\fR.
+\fBCCyymmddThh:mm:ss\fR. Note that only these three formats are accepted.
+The command does \fInot\fR accept the full range of point-in-time
+specifications specified in ISO8601. Other formats can be recognized by
+giving an explicit \fI-format\fR option to the \fBclock scan\fR command.
.TP
\fIrelative time\fR
A specification relative to the current time. The format is \fBnumber
-unit\fR. Acceptable units are \fByear\fR, \fBfortnight\fR, \fBmonth\fR, \fBweek\fR, \fBday\fR,
+unit\fR. Acceptable units are \fByear\fR, \fBfortnight\fR,
+\fBmonth\fR, \fBweek\fR, \fBday\fR,
\fBhour\fR, \fBminute\fR (or \fBmin\fR), and \fBsecond\fR (or \fBsec\fR). The
unit can be specified as a singular or plural, as in \fB3 weeks\fR.
These modifiers may also be specified: