summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--ChangeLog5
-rw-r--r--doc/Tcl.n15
2 files changed, 13 insertions, 7 deletions
diff --git a/ChangeLog b/ChangeLog
index 4d318d0..fe73bc7 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2009-11-30 Donal K. Fellows <dkf@users.sf.net>
+
+ * doc/Tcl.n: [Bug 2901433]: Improved description of expansion to
+ mention that it is using list syntax.
+
2009-11-27 Donal K. Fellows <dkf@users.sf.net>
* doc/BoolObj.3, doc/CrtChannel.3, doc/DictObj.3, doc/DoubleObj.3:
diff --git a/doc/Tcl.n b/doc/Tcl.n
index 06a99d0..90d11e3 100644
--- a/doc/Tcl.n
+++ b/doc/Tcl.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: Tcl.n,v 1.18 2007/12/13 15:22:32 dgp Exp $
+'\" RCS: @(#) $Id: Tcl.n,v 1.18.2.1 2009/11/30 15:44:00 dkf Exp $
'\"
.so man.macros
.TH Tcl n "8.5" Tcl "Tcl Built-In Commands"
@@ -56,14 +56,15 @@ If a word starts with the string
.QW {*}
followed by a non-whitespace character, then the leading
.QW {*}
-is removed
-and the rest of the word is parsed and substituted as any other
-word. After substitution, the word is parsed again without
-substitutions, and its words are added to the command being
+is removed and the rest of the word is parsed and substituted as any other
+word. After substitution, the word is parsed as a list (without command or
+variable substitutions; backslash substitutions are performed as is normal for
+a list and individual internal words may be surrounded by either braces or
+double-quote characters), and its words are added to the command being
substituted. For instance,
-.QW "cmd a {*}{b c} d {*}{e f}"
+.QW "cmd a {*}{b [c]} d {*}{$e f \"g h\"}"
is equivalent to
-.QW "cmd a b c d e f" .
+.QW "cmd a b {[c]} d {$e} f \"g h\"" .
.VE 8.5
.IP "[6] \fBBraces.\fR"
If the first character of a word is an open brace