summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authordkf <donal.k.fellows@manchester.ac.uk>2009-11-30 15:39:30 (GMT)
committerdkf <donal.k.fellows@manchester.ac.uk>2009-11-30 15:39:30 (GMT)
commit31f267b80c6db8240687b735e7ac5d5f63f2c8d2 (patch)
tree3d0bb19ccda5ced38389ad7302b7ddb55f796d49 /doc
parentd8f31f39067db330c33a736531132fa7d375885a (diff)
downloadtcl-31f267b80c6db8240687b735e7ac5d5f63f2c8d2.zip
tcl-31f267b80c6db8240687b735e7ac5d5f63f2c8d2.tar.gz
tcl-31f267b80c6db8240687b735e7ac5d5f63f2c8d2.tar.bz2
[Bug 2901433]: Improved description of {*} syntax.
Diffstat (limited to 'doc')
-rw-r--r--doc/Tcl.n15
1 files changed, 8 insertions, 7 deletions
diff --git a/doc/Tcl.n b/doc/Tcl.n
index d3ed71c..565be1d 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.21 2009/05/03 18:05:39 dkf Exp $
+'\" RCS: @(#) $Id: Tcl.n,v 1.22 2009/11/30 15:39:31 dkf Exp $
'\"
.so man.macros
.TH Tcl n "8.5" Tcl "Tcl Built-In Commands"
@@ -55,14 +55,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\"" .
.IP "[6] \fBBraces.\fR"
If the first character of a word is an open brace
.PQ {