Attachment "Tcl.n.patch" to
ticket [627455ffff]
added by
kennykb
2003-01-28 00:27:19.
Index: Tcl.n
===================================================================
RCS file: /cvsroot/tcl/tcl/doc/Tcl.n,v
retrieving revision 1.8
diff -u -r1.8 Tcl.n
--- Tcl.n 11 Nov 2002 16:08:28 -0000 1.8
+++ Tcl.n 27 Jan 2003 17:04:16 -0000
@@ -11,19 +11,20 @@
.TH Tcl n "8.1" Tcl "Tcl Built-In Commands"
.BS
.SH NAME
-Tcl \- Summary of Tcl language syntax.
+Tcl \- Tool Command Language
+.SH SYNOPSIS
+Summary of Tcl language syntax.
.BE
-
.SH DESCRIPTION
.PP
The following rules define the syntax and semantics of the Tcl language:
-.IP [1]
+.IP "[1] \fBCommands.\fR"
A Tcl script is a string containing one or more commands.
Semi-colons and newlines are command separators unless quoted as
described below.
Close brackets are command terminators during command substitution
(see below) unless quoted.
-.IP [2]
+.IP "[2] \fBEvaluation.\fR"
A command is evaluated in two steps.
First, the Tcl interpreter breaks the command into \fIwords\fR
and performs substitutions as described below.
@@ -36,10 +37,10 @@
in any way it likes, such as an integer, variable name, list,
or Tcl script.
Different commands interpret their words differently.
-.IP [3]
+.IP "[3] \fBWords.\fR"
Words of a command are separated by white space (except for
newlines, which are command separators).
-.IP [4]
+.IP "[4] \fBDouble quotes.\fR"
If the first character of a word is double-quote (``"'') then
the word is terminated by the next double-quote character.
If semi-colons, close brackets, or white space characters
@@ -48,7 +49,7 @@
Command substitution, variable substitution, and backslash substitution
are performed on the characters between the quotes as described below.
The double-quotes are not retained as part of the word.
-.IP [5]
+.IP "[5] \fBBraces.\fR"
If the first character of a word is an open brace (``{'') then
the word is terminated by the matching close brace (``}'').
Braces nest within the word: for each additional open
@@ -62,7 +63,7 @@
or white space receive any special interpretation.
The word will consist of exactly the characters between the
outer braces, not including the braces themselves.
-.IP [6]
+.IP "[6] \fBCommand substitution.\fR"
If a word contains an open bracket (``['') then Tcl performs
\fIcommand substitution\fR.
To do this it invokes the Tcl interpreter recursively to process
@@ -74,7 +75,7 @@
characters between them.
There may be any number of command substitutions in a single word.
Command substitution is not performed on words enclosed in braces.
-.IP [7]
+.IP "[7] \fBVariable substitution.\fR"
If a word contains a dollar-sign (``$'') then Tcl performs \fIvariable
substitution\fR: the dollar-sign and the following characters are
replaced in the word by the value of a variable.
@@ -101,7 +102,7 @@
There may be any number of variable substitutions in a single word.
Variable substitution is not performed on words enclosed in braces.
.RE
-.IP [8]
+.IP "[8] \fBBackslash substitution.\fR"
If a backslash (``\e'') appears within a word then
\fIbackslash substitution\fR occurs.
In all cases but those described below the backslash is dropped and
@@ -172,14 +173,14 @@
Backslash substitution is not performed on words enclosed in braces,
except for backslash-newline as described above.
.RE
-.IP [9]
+.IP "[9] \fBComments.\fR"
If a hash character (``#'') appears at a point where Tcl is
expecting the first character of the first word of a command,
then the hash character and the characters that follow it, up
through the next newline, are treated as a comment and ignored.
The comment character only has significance when it appears
at the beginning of a command.
-.IP [10]
+.IP "[10] \fBOrder of substitution.\fR"
Each character is processed exactly once by the Tcl interpreter
as part of creating the words of a command.
For example, if variable substitution occurs then no further
@@ -200,7 +201,7 @@
.CE
will always set the variable \fIy\fR to the value, \fI012\fR.
.RE
-.IP [11]
+.IP "[11] \fBSubstitution and word boundaries.\fR"
Substitutions do not affect the word boundaries of a command.
For example, during variable substitution the entire value of
the variable becomes part of a single word, even if the variable's