[Bug 2901433]: Improved description of {*} syntax.

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 {