diff options
author | dgp <dgp@noemail.net> | 2003-09-04 16:44:11 (GMT) |
---|---|---|
committer | dgp <dgp@noemail.net> | 2003-09-04 16:44:11 (GMT) |
commit | 5ea10dde185011165830426cdc062d74ac4a4b75 (patch) | |
tree | e4dab2e65e57de3f104811a01c704395859cc326 /doc | |
parent | 5db3abb8e79a0dc9cd93682b6d2bf9c989e43dff (diff) | |
download | tcl-5ea10dde185011165830426cdc062d74ac4a4b75.zip tcl-5ea10dde185011165830426cdc062d74ac4a4b75.tar.gz tcl-5ea10dde185011165830426cdc062d74ac4a4b75.tar.bz2 |
* doc/SplitList.3: Implementation of TIP 148. Fixes [Bug 489537].
* generic/tcl.h: Updated Tcl_ConvertCountedElement() to quote
* generic/tclUtil.c: the leading "#" character of all list elements
unless the TCL_DONT_QUOTE_HASH flag is passed in.
* generic/tclDictObj.c: Updated Tcl_ConvertCountedElement() callers
* generic/tclListObj.c: to pass in the TCL_DONT_QUOTE_HASH flags
* generic/tclResult.c: when appropriate.
FossilOrigin-Name: 3195fccabac53d639ef916647c417d7cbbb4135f
Diffstat (limited to 'doc')
-rw-r--r-- | doc/SplitList.3 | 14 |
1 files changed, 13 insertions, 1 deletions
diff --git a/doc/SplitList.3 b/doc/SplitList.3 index c046af5..a237293 100644 --- a/doc/SplitList.3 +++ b/doc/SplitList.3 @@ -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: SplitList.3,v 1.6 2002/01/25 20:40:55 dgp Exp $ +'\" RCS: @(#) $Id: SplitList.3,v 1.7 2003/09/04 16:44:12 dgp Exp $ '\" .so man.macros .TH Tcl_SplitList 3 8.0 Tcl "Tcl Library Procedures" @@ -166,6 +166,18 @@ used to generate a portion of an argument for a Tcl command. In this case, surrounding \fIsrc\fR with curly braces would cause the command not to be parsed correctly. .PP +.VS 8.5 +By default, \fBTcl_ConvertElement\fR will use quoting in its output +to be sure the first character of an element is not the hash +character (``#''). This is to be sure the first element of any list +passed to \fBeval\fR is not mis-parsed as the beginning of a comment. +When a list element is not the first element of a list, this quoting +is not necessary. When the caller can be sure that the element is +not the first element of a list, it can disable quoting of the leading +hash character by OR-ing the flag value returned by \fBTcl_ScanElement\fR +with \fBTCL_DONT_QUOTE_HASH\fR. +.VE 8.5 +.PP \fBTcl_ScanCountedElement\fR and \fBTcl_ConvertCountedElement\fR are the same as \fBTcl_ScanElement\fR and \fBTcl_ConvertElement\fR, except the length of string \fIsrc\fR is specified by the \fIlength\fR |