Add note to clock.n disclaiming full ISO8601 support

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: