diff options
| -rw-r--r-- | ChangeLog | 6 | ||||
| -rw-r--r-- | doc/chan.n | 6 | ||||
| -rw-r--r-- | doc/clock.n | 6 | ||||
| -rw-r--r-- | doc/eval.n | 4 | ||||
| -rw-r--r-- | doc/exit.n | 4 | ||||
| -rw-r--r-- | doc/expr.n | 4 | ||||
| -rw-r--r-- | doc/interp.n | 12 | ||||
| -rw-r--r-- | doc/open.n | 4 | ||||
| -rw-r--r-- | doc/platform_shell.n | 6 | ||||
| -rw-r--r-- | doc/pwd.n | 4 | ||||
| -rw-r--r-- | doc/refchan.n | 10 | ||||
| -rw-r--r-- | doc/regsub.n | 4 | ||||
| -rw-r--r-- | doc/scan.n | 12 | ||||
| -rw-r--r-- | doc/tclvars.n | 4 | ||||
| -rw-r--r-- | doc/tm.n | 4 | ||||
| -rw-r--r-- | doc/unload.n | 6 |
16 files changed, 51 insertions, 45 deletions
@@ -1,5 +1,11 @@ 2007-02-18 Donal K. Fellows <dkf@users.sf.net> + * doc/chan.n, doc/clock.n, doc/eval.n, doc/exit.n, doc/expr.n: + * doc/interp.n, doc/open.n, doc/platform_shell.n, doc/pwd.n: + * doc/refchan.n, doc/regsub.n, doc/scan.n, doc/tclvars.n, doc/tm.n: + * doc/unload.n: Apply [Bug 1610310] to fix typos. Thanks to Larry + Virden for spotting them. + * doc/interp.n: Partial fix of [Bug 1662436]; rest requires some policy decisions on what should and shouldn't be safe commands from the "new in 8.5" set. @@ -4,7 +4,7 @@ '\" See the file "license.terms" for information on usage and redistribution '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES. '\" -'\" RCS: @(#) $Id: chan.n,v 1.8 2006/12/06 01:42:00 das Exp $ +'\" RCS: @(#) $Id: chan.n,v 1.9 2007/02/18 18:42:54 dkf Exp $ .so man.macros .TH chan n 8.5 Tcl "Tcl Built-In Commands" .BS @@ -352,7 +352,7 @@ interpreter, even if the channel was shared with and/or was moved into a different interpreter. Each reflected channel also knows the thread it was created in, and executes its handler command only in that thread, even if the channel was moved into a different thread. To this -end all invokations of the handler are forwarded to the original +end all invocations of the handler are forwarded to the original thread by posting special events to it. This means that the original thread (i.e. the thread that executed the \fBchan create\fR command) must have an active event loop, i.e. it must be able to process such @@ -384,7 +384,7 @@ within the safe interpreter. . Test whether the last input operation on the channel called \fIchannelId\fR failed because the end of the data stream was reached, -returning 1 if end-fo-file was reached, and 0 otherwise. +returning 1 if end-of-file was reached, and 0 otherwise. .TP \fBchan event \fIchannelId event\fR ?\fIscript\fR? . diff --git a/doc/clock.n b/doc/clock.n index d4d09e8..0bcb665 100644 --- a/doc/clock.n +++ b/doc/clock.n @@ -88,7 +88,7 @@ have 59 or 61 seconds. \fIunit\fR One of the words, \fBseconds\fR, \fBminutes\fR, \fBhours\fR, \fBdays\fR, \fBweeks\fR, \fBmonths\fR, or \fByears\fR, or -any unique prefix of such a word. Used in conjuction with \fIcount\fR +any unique prefix of such a word. Used in conjunction with \fIcount\fR to identify an interval of time, for example, \fI3 seconds\fR or \fI1 year\fR. .SH "OPTIONS" @@ -267,7 +267,7 @@ representation that \fBclock seconds\fR returns. There are three exceptions, which are all intended for use where higher-resolution times are required. \fBclock milliseconds\fR returns the count of milliseconds from the epoch time, and \fBclock microseconds\fR returns the count of microseconds -from the epoch time. In addition, there js a \fBclock clicks\fR command +from the epoch time. In addition, there is a \fBclock clicks\fR command that returns a platform-dependent high-resolution timer. Unlike \fBclock seconds\fR and \fBclock milliseconds\fR, the value of \fBclock clicks\fR is not guaranteed to be tied to any fixed @@ -705,7 +705,7 @@ Brazilian Standard Time. It is recommended that date/time strings for use by computers use numeric time zones instead. .TP \fB%%\fR -On output, produces a literal '\fB%\fR' charater. On input, matches +On output, produces a literal '\fB%\fR' character. On input, matches a literal '\fB%\fR' character. .TP \fB%+\fR @@ -5,7 +5,7 @@ '\" See the file "license.terms" for information on usage and redistribution '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES. '\" -'\" RCS: @(#) $Id: eval.n,v 1.7 2006/11/03 00:34:51 hobbs Exp $ +'\" RCS: @(#) $Id: eval.n,v 1.8 2007/02/18 18:42:54 dkf Exp $ '\" .so man.macros .TH eval n "" Tcl "Tcl Built-In Commands" @@ -53,7 +53,7 @@ for {set i 0} {$i<10} {incr i} { .VS 8.5 Note that in the most common case (where the script fragment is actually just a list of words forming a command prefix), it is better -to use \fB{*}$script\fR when doing this sort of invokation +to use \fB{*}$script\fR when doing this sort of invocation pattern. It is less general than the \fBeval\fR command, and hence easier to make robust in practice. .VE 8.5 @@ -5,7 +5,7 @@ '\" See the file "license.terms" for information on usage and redistribution '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES. '\" -'\" RCS: @(#) $Id: exit.n,v 1.6 2004/11/20 00:17:32 dgp Exp $ +'\" RCS: @(#) $Id: exit.n,v 1.7 2007/02/18 18:42:54 dkf Exp $ '\" .so man.macros .TH exit n "" Tcl "Tcl Built-In Commands" @@ -26,7 +26,7 @@ to 0. .SH EXAMPLE Since non-zero exit codes are usually interpreted as error cases by the calling process, the \fBexit\fR command is an important part of -signalling that something fatal has gone wrong. This code fragment is +signaling that something fatal has gone wrong. This code fragment is useful in scripts to act as a general problem trap: .CS proc main {} { @@ -6,7 +6,7 @@ '\" See the file "license.terms" for information on usage and redistribution '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES. '\" -'\" RCS: @(#) $Id: expr.n,v 1.23 2006/08/09 10:06:28 dkf Exp $ +'\" RCS: @(#) $Id: expr.n,v 1.24 2007/02/18 18:42:54 dkf Exp $ '\" .so man.macros .TH expr n 8.5 Tcl "Tcl Built-In Commands" @@ -247,7 +247,7 @@ integer calculations are performed exactly. Note that in Tcl releases prior to 8.5, integer calculations were performed with one of the C types \fIlong int\fR or \fITcl_WideInt\fR, causing implicit range truncation in those calculations where values overflowed the range of those types. -Any code that relied on these implicit trunctions will need to explicitly +Any code that relied on these implicit truncations will need to explicitly add \fBint()\fR or \fBwide()\fR function calls to expressions at the points where such truncation is required to take place. .VE 8.5 diff --git a/doc/interp.n b/doc/interp.n index 615fbbd..8b32ee0 100644 --- a/doc/interp.n +++ b/doc/interp.n @@ -5,7 +5,7 @@ '\" See the file "license.terms" for information on usage and redistribution '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES. '\" -'\" RCS: @(#) $Id: interp.n,v 1.26 2007/02/18 01:06:14 dkf Exp $ +'\" RCS: @(#) $Id: interp.n,v 1.27 2007/02/18 18:42:54 dkf Exp $ '\" .so man.macros .TH interp n 7.6 Tcl "Tcl Built-In Commands" @@ -689,7 +689,7 @@ reading and writing the option when the particular limit in the limited interpreter is exceeded. The callback may modify the limit on the interpreter if it wishes the limited interpreter to continue executing. If the callback generates an error, it is reported through -the background error mechansism (see \fBBACKGROUND ERROR HANDLING\fR). +the background error mechanism (see \fBBACKGROUND ERROR HANDLING\fR). Note that the callbacks defined by one interpreter are completely isolated from the callbacks defined by another, and that the order in which those @@ -708,7 +708,7 @@ This option specifies the number of milliseconds after the moment defined in the \fB\-seconds\fR option that the time limit will fire. It should only ever be specified in conjunction with the \fB\-seconds\fR option (whether it was set previously or is being set -this invokation.) +this invocation.) .TP \fB\-seconds\fR This option specifies the number of seconds after the epoch (see @@ -745,7 +745,7 @@ namespace to be called, but other error handlers may be installed and process background errors in substantially different ways. .PP A background error handler consists of a non-empty list of words to -which will, at invokation time, be appended two further words. The +which will, at invocation time, be appended two further words. The first word will be the error message string, and the second will a dictionary of return options (this is also the sort of information that can be obtained by trapping a normal error using \fBcatch\fR of @@ -763,13 +763,13 @@ set idx [getIndex delta] .CE .PP Executing an arbitrary command in a safe interpreter where every -invokation of \fBlappend\fR is logged: +invocation of \fBlappend\fR is logged: .CS set i [\fBinterp create\fR -safe] \fBinterp hide\fR $i lappend \fBinterp alias\fR $i lappend {} loggedLappend $i proc loggedLappend {i args} { - puts "logged invokation of lappend $args" + puts "logged invocation of lappend $args" \fBinterp invokehidden\fR $i lappend {*}$args } \fBinterp eval\fR $i $someUntrustedScript @@ -5,7 +5,7 @@ '\" See the file "license.terms" for information on usage and redistribution '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES. '\" -'\" RCS: @(#) $Id: open.n,v 1.27 2006/04/12 02:35:06 das Exp $ +'\" RCS: @(#) $Id: open.n,v 1.28 2007/02/18 18:42:55 dkf Exp $ '\" .so man.macros .TH open n 8.3 Tcl "Tcl Built-In Commands" @@ -88,7 +88,7 @@ Set the file pointer to the end of the file prior to each write. .VS 8.5 .TP 15 \fBBINARY\fR -Configure the opened channed with the \fB-translation binary\fR option. +Configure the opened channel with the \fB-translation binary\fR option. .VE 8.5 .TP 15 \fBCREAT\fR diff --git a/doc/platform_shell.n b/doc/platform_shell.n index bbeba9f..f3ef6b9 100644 --- a/doc/platform_shell.n +++ b/doc/platform_shell.n @@ -4,7 +4,7 @@ '\" See the file "license.terms" for information on usage and redistribution '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES. '\" -'\" RCS: @(#) $Id: platform_shell.n,v 1.2 2006/12/06 01:42:00 das Exp $ +'\" RCS: @(#) $Id: platform_shell.n,v 1.3 2007/02/18 18:42:55 dkf Exp $ '\" .so man.macros .TH "platform::shell" n 1.0.2 platform::shell "Tcl Bundled Packages" @@ -32,10 +32,10 @@ only requirement is that the other shell (identified by its path), is actually executable on the current machine. .PP While for most platform this means that the architecture of the -interogated shell is identical to the architecture of the running +interrogated shell is identical to the architecture of the running shell this is not generally true. A counter example are all platforms which have 32 and 64 bit variants and where a 64bit system is able to -run 32bit code. For these running and interogated shell may have +run 32bit code. For these running and interrogated shell may have different 32/64 bit settings and thus different identifiers. .PP For applications like a code repository it is important to identify @@ -5,7 +5,7 @@ '\" See the file "license.terms" for information on usage and redistribution '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES. '\" -'\" RCS: @(#) $Id: pwd.n,v 1.6 2004/10/27 14:24:37 dkf Exp $ +'\" RCS: @(#) $Id: pwd.n,v 1.7 2007/02/18 18:42:55 dkf Exp $ '\" .so man.macros .TH pwd n "" Tcl "Tcl Built-In Commands" @@ -24,7 +24,7 @@ Returns the absolute path name of the current working directory. Sometimes it is useful to change to a known directory when running some external command using \fBexec\fR, but it is important to keep the application usually running in the directory that it was started -in (unless the user specifies otherwise) since that minimises user +in (unless the user specifies otherwise) since that minimizes user confusion. The way to do this is to save the current directory while the external command is being run: .CS diff --git a/doc/refchan.n b/doc/refchan.n index 44d7742..04b0785 100644 --- a/doc/refchan.n +++ b/doc/refchan.n @@ -4,7 +4,7 @@ '\" See the file "license.terms" for information on usage and redistribution '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES. '\" -'\" RCS: @(#) $Id: refchan.n,v 1.4 2006/07/28 10:38:00 das Exp $ +'\" RCS: @(#) $Id: refchan.n,v 1.5 2007/02/18 18:42:55 dkf Exp $ .so man.macros .TH reflectedchan n 8.5 Tcl "Tcl Built-In Commands" .BS @@ -32,7 +32,7 @@ other subcommands is optional. .TP \fIcmdPrefix \fBinitialize \fIchannelId mode\fR . -An invokation of this subcommand will be the first call the +An invocation of this subcommand will be the first call the \fIcmdPrefix\fR will receive for the specified new \fIchannelId\fR. It is the responsibility of this subcommand to set up any internal data structures required to keep track of the channel and its state. @@ -62,7 +62,7 @@ supported by the \fIcmdPrefix\fR. .TP \fIcmdPrefix \fBfinalize \fIchannelId\fR . -An invokation of this subcommand will be the last call the +An invocation of this subcommand will be the last call the \fIcmdPrefix\fR will receive for the specified \fIchannelId\fR. It will be generated just before the destruction of the data structures of the channel held by the Tcl core. The command handler \fImust not\fR @@ -98,7 +98,7 @@ custom return codes. .PP This subcommand interacts with \fBchan postevent\fR. Trying to post an event which was not listed in the last call to \fBwatch\fR will cause -\fBchan postenvent\fR to throw an error. +\fBchan postevent\fR to throw an error. .RE .SS "OPTIONAL SUBCOMMANDS" .TP @@ -112,7 +112,7 @@ from the channel handled by the command. .PP The return value of this subcommand is taken as the requested data \fIbytes\fR. If the returned data contains more bytes than requested, -an error will be signalled and later thrown by the command which +an error will be signaled and later thrown by the command which performed the read (usually \fBgets\fR or \fBread\fR). However, returning fewer bytes than requested is acceptable. .PP diff --git a/doc/regsub.n b/doc/regsub.n index 53b8dd4..333c776 100644 --- a/doc/regsub.n +++ b/doc/regsub.n @@ -6,7 +6,7 @@ '\" See the file "license.terms" for information on usage and redistribution '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES. '\" -'\" RCS: @(#) $Id: regsub.n,v 1.15 2005/05/10 18:34:03 kennykb Exp $ +'\" RCS: @(#) $Id: regsub.n,v 1.16 2007/02/18 18:42:55 dkf Exp $ '\" .so man.macros .TH regsub n 8.3 Tcl "Tcl Built-In Commands" @@ -119,7 +119,7 @@ Replace (in the string in variable \fIstring\fR) every instance of .CE .PP Insert double-quotes around the first instance of the word -\fBinteresting\fR, however it is capitalised. +\fBinteresting\fR, however it is capitalized. .CS \fBregsub\fR -nocase {\e<interesting\e>} $string {"&"} string .CE @@ -6,7 +6,7 @@ '\" See the file "license.terms" for information on usage and redistribution '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES. '\" -'\" RCS: @(#) $Id: scan.n,v 1.18 2006/06/14 14:59:03 dkf Exp $ +'\" RCS: @(#) $Id: scan.n,v 1.19 2007/02/18 18:42:55 dkf Exp $ '\" .so man.macros .TH scan n 8.4 Tcl "Tcl Built-In Commands" @@ -80,10 +80,10 @@ to the absence of a size modifier in the the conversion specifier. Either one indicates the integer range to be stored is limited to the same range produced by the \fBint()\fR function of the \fBexpr\fR command. The \fBL\fR size modifier is equivalent to the \fBl\fR size -modifer. Either one indicates the integer range to be stored is +modifier. Either one indicates the integer range to be stored is limited to the same range produced by the \fBwide()\fR function of the \fBexpr\fR command. The \fBll\fR size modifier indicates that -the integer range ro be stored is unlimited. +the integer range to be stored is unlimited. .VE 8.5 .PP The following conversion characters are supported: @@ -108,8 +108,8 @@ The input substring must be a decimal integer. The integer value is truncated as required by the size modifier value, and the corresponding unsigned value for that truncated range is computed and stored in the variable as a decimal string. -The conversion makes no sense without refernce to a truncation range, -so the size modifer \fBll\fR is not permitted in combination +The conversion makes no sense without reference to a truncation range, +so the size modifier \fBll\fR is not permitted in combination with conversion character \fBu\fR. .TP 10 \fBi\fR @@ -159,7 +159,7 @@ contains a sequence of the form \fIa\fB\-\fIb\fR then any character between \fIa\fR and \fIb\fR (inclusive) will be excluded from the set. If the first or last character between the brackets is a \fB\-\fR, then -it is treated as part of \fIchars\fR rather than indicating a ranvaluege. +it is treated as part of \fIchars\fR rather than indicating a range value. .TP 10 \fBn\fR No input is consumed from the input string. Instead, the total number diff --git a/doc/tclvars.n b/doc/tclvars.n index b16ceb9..6b59a3a 100644 --- a/doc/tclvars.n +++ b/doc/tclvars.n @@ -5,7 +5,7 @@ '\" See the file "license.terms" for information on usage and redistribution '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES. '\" -'\" RCS: @(#) $Id: tclvars.n,v 1.26 2006/12/05 18:45:50 andreas_kupries Exp $ +'\" RCS: @(#) $Id: tclvars.n,v 1.27 2007/02/18 18:42:55 dkf Exp $ '\" .so man.macros .TH tclvars n 8.0 Tcl "Tcl Built-In Commands" @@ -377,7 +377,7 @@ Contains 1 if \fBtclsh\fR or \fBwish\fR is running interactively (no script was specified and standard input is a terminal-like device), 0 otherwise. .PP -The \fBwish\fR executably additionally specifies the following global +The \fBwish\fR executable additionally specifies the following global variable: .TP 6 \fBgeometry\fR @@ -4,7 +4,7 @@ '\" See the file "license.terms" for information on usage and redistribution '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES. '\" -'\" RCS: @(#) $Id: tm.n,v 1.5 2004/11/12 09:01:25 das Exp $ +'\" RCS: @(#) $Id: tm.n,v 1.6 2007/02/18 18:42:55 dkf Exp $ '\" .so man.macros .TH tm n 8.5 Tcl "Tcl Built-In Commands" @@ -66,7 +66,7 @@ to the list of paths to search. This command is used internally by the system to set up the system-specific default paths. .PP -The command has been exposed to allow a buildsystem to define +The command has been exposed to allow a build system to define additional root paths beyond those described by this document. .RE .SH "MODULE DEFINITION" diff --git a/doc/unload.n b/doc/unload.n index 8a2e51c..f9674c3 100644 --- a/doc/unload.n +++ b/doc/unload.n @@ -4,7 +4,7 @@ '\" See the file "license.terms" for information on usage and redistribution '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES. '\" -'\" RCS: @(#) $Id: unload.n,v 1.8 2005/05/10 18:34:03 kennykb Exp $ +'\" RCS: @(#) $Id: unload.n,v 1.9 2007/02/18 18:42:55 dkf Exp $ '\" .so man.macros .TH unload n 8.5 Tcl "Tcl Built-In Commands" @@ -41,7 +41,7 @@ they are treated as switches. The following switches are currently supported: .TP \fB\-nocomplain\fR -Supresses all error messages. If this switch is given \fBunload\fR will +Suppresses all error messages. If this switch is given, \fBunload\fR will never report an error. .TP \fB\-keeplibrary\fR @@ -59,7 +59,7 @@ loaded into normal (trusted) interpreters while the second describes how many times the library has been loaded into safe interpreters. As a file containing a shared library can be loaded only once by Tcl (with the first \fBload\fR call on the file), these counters track how many interpreters use the library. -Each subsequent call to \fBload\fR after the first, simply increaments the +Each subsequent call to \fBload\fR after the first simply increments the proper reference count. .PP \fBunload\fR works in the opposite direction. As a first step, \fBunload\fR |