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

2 files changed, 18 insertions, 12 deletions

diff --git a/ChangeLog b/ChangeLog
index 9399af2..0f90676 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,10 +1,15 @@
+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  Kevin B. Kenny  <kennykb@acm.org>
 
-	* win/tclAppInit.c (Tcl_AppInit): Reverted Jan's change that added
-	a call to Tcl_InitStubs.  'tclsh' and 'tcltest' are providers, not
-	consumers of the Stubs table, and should not link with the Stubs
-	library, but only with the main Tcl library. (In any case, the
-	presence of Tcl_InitStubs broke the build.) [Bug 2902965]
+	* win/tclAppInit.c (Tcl_AppInit): [Bug 2902965]: Reverted Jan's change
+	that added a call to Tcl_InitStubs. The 'tclsh' and 'tcltest' programs
+	are providers, not consumers of the Stubs table, and should not link
+	with the Stubs library, but only with the main Tcl library. (In any
+	case, the presence of Tcl_InitStubs broke the build.)
 	
 2009-11-27  Donal K. Fellows  <dkf@users.sf.net>
 
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 {