summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorjan.nijtmans <nijtmans@users.sourceforge.net>2024-08-05 22:44:50 (GMT)
committerjan.nijtmans <nijtmans@users.sourceforge.net>2024-08-05 22:44:50 (GMT)
commit76718af2027a541a834a6979b532a1daf4c900cf (patch)
tree88aa29a55f76be3ffa453dee37a428ce11e0eaa4 /doc
parent9bf8cbc6796704b68d292afb1ba03295c453831b (diff)
downloadtcl-76718af2027a541a834a6979b532a1daf4c900cf.zip
tcl-76718af2027a541a834a6979b532a1daf4c900cf.tar.gz
tcl-76718af2027a541a834a6979b532a1daf4c900cf.tar.bz2
Missed some backports from 9.0. Some indenting
Diffstat (limited to 'doc')
-rw-r--r--doc/clock.n15
-rw-r--r--doc/library.n2
-rw-r--r--doc/msgcat.n11
-rw-r--r--doc/object.n1
4 files changed, 20 insertions, 9 deletions
diff --git a/doc/clock.n b/doc/clock.n
index 8a54e07..12897b2 100644
--- a/doc/clock.n
+++ b/doc/clock.n
@@ -113,7 +113,7 @@ Specifies the desired output format for \fBclock format\fR or the
expected input format for \fBclock scan\fR. The \fIformat\fR string consists
of any number of characters other than the per-cent sign
.PQ \fB%\fR
-interspersed with any number of \fIformat groups\fR, which are two-character
+interspersed with any number of \fIformat groups\fR, which are two- or three-character
sequences beginning with the per-cent sign. The permissible format groups,
and their interpretation, are described under \fBFORMAT GROUPS\fR.
.RS
@@ -169,6 +169,15 @@ the environment variable \fBTZ\fR.
.IP [3]
on Windows systems, the time zone settings from the Control Panel.
.RE
+.\" OPTION: -validate
+.TP
+\fB\-validate\fR boolean
+.
+If \fIboolean\fR is true, \fBclock scan\fR will raise an error if the
+input contains invalid values, e.g. day of month greater than number
+of days in the month. If specified as false (default), the command
+makes an adjustment to bring values within acceptable range. See
+\fBSCANNING TIMES\fR for details.
.PP
If none of these is present, the C \fBlocaltime\fR and \fBmktime\fR
functions are used to attempt to convert times between local and
@@ -467,7 +476,9 @@ time zone when converting local times. This caveat does not apply to
UTC times.)
.PP
If the interpretation of the groups yields an impossible time because
-a field is out of range, enough of that field's unit will be added to
+a field is out of range, an exception is raised if the \fB-validate\fR
+option is passed as true. If passed as false or not present,
+enough of that field's unit will be added to
or subtracted from the time to bring it in range. Thus, if attempting to
scan or format day 0 of the month, one day will be subtracted from day
1 of the month, yielding the last day of the previous month.
diff --git a/doc/library.n b/doc/library.n
index 0342cbe..5c364bb 100644
--- a/doc/library.n
+++ b/doc/library.n
@@ -9,7 +9,7 @@
.so man.macros
.BS
.SH NAME
-auto_execok, auto_import, auto_load, auto_mkindex, auto_qualify, auto_reset, tcl_findLibrary, parray, tcl_endOfWord, tcl_startOfNextWord, tcl_startOfPreviousWord, tcl_wordBreakAfter, tcl_wordBreakBefore \- standard library of Tcl procedures
+auto_execok, auto_import, auto_load, auto_mkindex, auto_qualify, auto_reset, foreachLine, parray, readFile, tcl_findLibrary, tcl_endOfWord, tcl_startOfNextWord, tcl_startOfPreviousWord, tcl_wordBreakAfter, tcl_wordBreakBefore, writeFile \- standard library of Tcl procedures
.SH SYNOPSIS
.nf
\fBauto_execok \fIcmd\fR
diff --git a/doc/msgcat.n b/doc/msgcat.n
index 9d82688..f486326 100644
--- a/doc/msgcat.n
+++ b/doc/msgcat.n
@@ -35,7 +35,7 @@ msgcat \- Tcl message catalog
.VE "TIP 499"
.sp
.VS "TIP 412"
-\fB::msgcat::mcloadedlocales subcommand\fR ?\fIlocale\fR?
+\fB::msgcat::mcloadedlocales subcommand\fR
.VE "TIP 412"
.sp
\fB::msgcat::mcload \fIdirname\fR
@@ -239,7 +239,7 @@ configured by:
.PP
.\" COMMAND: mcloadedlocales
.TP
-\fB::msgcat::mcloadedlocales subcommand\fR ?\fIlocale\fR?
+\fB::msgcat::mcloadedlocales subcommand\fR
.VS "TIP 499"
This group of commands manage the list of loaded locales for packages not
setting a package locale.
@@ -399,10 +399,9 @@ language[_country][_modifier]
.PP
On Windows and Cygwin, if none of those environment variables is set,
msgcat will attempt to extract locale information from the registry.
-From Windows Vista on, the RFC4747 locale name "lang-script-country-options"
+The RFC4747 locale name "lang-script-country-options"
is transformed to the locale as "lang_country_script" (Example:
-sr-Latn-CS -> sr_cs_latin). For Windows XP, the language id is
-transformed analogously (Example: 0c1a -> sr_yu_cyrillic).
+sr-Latn-CS -> sr_cs_latin).
If all these attempts to discover an initial locale from the user's
environment fail, msgcat defaults to an initial locale of
.QW C .
@@ -615,7 +614,7 @@ If a set of locale preferences is given, it is set as package locale preference
list. The package locale is set to the first element of the preference list.
A package locale is activated, if it was not set so far.
.PP
-Locale preferences are loaded now for the package, if not jet loaded.
+Locale preferences are loaded now for the package, if not yet loaded.
.VE "TIP 499"
.RE
.PP
diff --git a/doc/object.n b/doc/object.n
index 7bdbbe2..96f5d39 100644
--- a/doc/object.n
+++ b/doc/object.n
@@ -69,6 +69,7 @@ associated with \fIobj\fR, returning the result of the evaluation.
Note that object-internal commands such as \fBmy\fR and \fBself\fR can be
invoked in this context.
.RE
+.\" METHOD: unknown
.TP
\fIobj \fBunknown ?\fImethodName\fR? ?\fIarg ...\fR?
.