summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authordkf <donal.k.fellows@manchester.ac.uk>2009-05-03 18:05:38 (GMT)
committerdkf <donal.k.fellows@manchester.ac.uk>2009-05-03 18:05:38 (GMT)
commitba58e6442af44bef063652e496e60f09826716ec (patch)
treeb1914b32cf3b6cb3821a26bc4c57cb678a9f524d
parentbced9b54274c34b3cb12fa8875327756c728ab18 (diff)
downloadtcl-ba58e6442af44bef063652e496e60f09826716ec.zip
tcl-ba58e6442af44bef063652e496e60f09826716ec.tar.gz
tcl-ba58e6442af44bef063652e496e60f09826716ec.tar.bz2
Fix [Bug 2538432] through clarification.
-rw-r--r--ChangeLog6
-rw-r--r--doc/Tcl.n19
2 files changed, 22 insertions, 3 deletions
diff --git a/ChangeLog b/ChangeLog
index 3c4651f..91c6ff7 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2009-05-03 Donal K. Fellows <dkf@users.sf.net>
+
+ * doc/Tcl.n: [Bug 2538432]: Clarified exact treatment of ${arr(idx)}
+ form of variable substitution. This is not a change of behavior, just
+ an improved description of the current situation.
+
2009-04-30 Miguel Sofer <msofer@users.sf.net>
* generic/tclBasic.c (TclObjInvoke): Make sure that a null objProc
diff --git a/doc/Tcl.n b/doc/Tcl.n
index e486869..d3ed71c 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.20 2008/10/15 10:43:37 dkf Exp $
+'\" RCS: @(#) $Id: Tcl.n,v 1.21 2009/05/03 18:05:39 dkf Exp $
'\"
.so man.macros
.TH Tcl n "8.5" Tcl "Tcl Built-In Commands"
@@ -121,8 +121,17 @@ substitutions are performed on the characters of \fIindex\fR.
.TP 15
\fB${\fIname\fB}\fR
.
-\fIName\fR is the name of a scalar variable. It may contain any
-characters whatsoever except for close braces.
+\fIName\fR is the name of a scalar variable or array element. It may contain
+any characters whatsoever except for close braces. It indicates an array
+element if \fIname\fR is in the form
+.QW \fIarrayName\fB(\fIindex\fB)\fR
+where \fIarrayName\fR does not contain any open parenthesis characters,
+.QW \fB(\fR ,
+or close brace characters,
+.QW \fB}\fR ,
+and \fIindex\fR can be any sequence of characters except for close brace
+characters. No further
+substitutions are performed during the parsing of \fIname\fR.
.PP
There may be any number of variable substitutions in a single word.
Variable substitution is not performed on words enclosed in braces.
@@ -236,3 +245,7 @@ except for argument expansion as specified in rule [5].
For example, during variable substitution the entire value of
the variable becomes part of a single word, even if the variable's
value contains spaces.
+'\" Local Variables:
+'\" mode: nroff
+'\" fill-column: 78
+'\" End: