From 31f267b80c6db8240687b735e7ac5d5f63f2c8d2 Mon Sep 17 00:00:00 2001 From: dkf Date: Mon, 30 Nov 2009 15:39:30 +0000 Subject: [Bug 2901433]: Improved description of {*} syntax. --- ChangeLog | 15 ++++++++++----- doc/Tcl.n | 15 ++++++++------- 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 + + * doc/Tcl.n: [Bug 2901433]: Improved description of expansion to + mention that it is using list syntax. + 2009-11-27 Kevin B. Kenny - * 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 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 { -- cgit v0.12