* 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.

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