summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorKevin B Kenny <kennykb@acm.org>2003-02-01 19:48:22 (GMT)
committerKevin B Kenny <kennykb@acm.org>2003-02-01 19:48:22 (GMT)
commitb6d2ba95de66b5c89d10d8861df1b8d02ec7dcc2 (patch)
tree0b45b8ab91562620a255d76f95bbd7ce80fc33af
parent8ca7da652a892daee3f4847a3003b6c2abb621d0 (diff)
downloadtcl-b6d2ba95de66b5c89d10d8861df1b8d02ec7dcc2.zip
tcl-b6d2ba95de66b5c89d10d8861df1b8d02ec7dcc2.tar.gz
tcl-b6d2ba95de66b5c89d10d8861df1b8d02ec7dcc2.tar.bz2
2003-02-01 Kevin Kenny <kennykb@users.sourceforge.net>
* doc/Tcl.n: Added headings to the eleven paragraphs, to improve formatting in the tools that attempt to extract tables of contents from the manual pages. [Bug 627455] * generic/tclClock.c: Expanded mutex protection around the setting of env(TZ) and the thread-unsafe call to tzset(). [Bug 656660]
-rw-r--r--ChangeLog9
-rw-r--r--doc/Tcl.n29
-rw-r--r--generic/tclClock.c14
3 files changed, 36 insertions, 16 deletions
diff --git a/ChangeLog b/ChangeLog
index 97d93cd..5378c05 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,12 @@
+2003-02-01 Kevin Kenny <kennykb@users.sourceforge.net>
+
+ * doc/Tcl.n: Added headings to the eleven paragraphs, to improve
+ formatting in the tools that attempt to extract tables of contents
+ from the manual pages. [Bug 627455]
+
+ * generic/tclClock.c: Expanded mutex protection around the setting
+ of env(TZ) and the thread-unsafe call to tzset(). [Bug 656660]
+
2003-01-31 Don Porter <dgp@users.sourceforge.net>
* tests/tcltest.test: Cleaned up management of file/directory
diff --git a/doc/Tcl.n b/doc/Tcl.n
index 80f4337..af6bd69 100644
--- a/doc/Tcl.n
+++ b/doc/Tcl.n
@@ -5,25 +5,26 @@
'\" 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.8 2002/11/11 16:08:28 kennykb Exp $
+'\" RCS: @(#) $Id: Tcl.n,v 1.9 2003/02/01 19:48:23 kennykb Exp $
'\"
.so man.macros
.TH Tcl n "8.1" Tcl "Tcl Built-In Commands"
.BS
.SH NAME
-Tcl \- Summary of Tcl language syntax.
+Tcl \- Tool Command Language
+.SH SYNOPSIS
+Summary of Tcl language syntax.
.BE
-
.SH DESCRIPTION
.PP
The following rules define the syntax and semantics of the Tcl language:
-.IP [1]
+.IP "[1] \fBCommands.\fR"
A Tcl script is a string containing one or more commands.
Semi-colons and newlines are command separators unless quoted as
described below.
Close brackets are command terminators during command substitution
(see below) unless quoted.
-.IP [2]
+.IP "[2] \fBEvaluation.\fR"
A command is evaluated in two steps.
First, the Tcl interpreter breaks the command into \fIwords\fR
and performs substitutions as described below.
@@ -36,10 +37,10 @@ The command procedure is free to interpret each of its words
in any way it likes, such as an integer, variable name, list,
or Tcl script.
Different commands interpret their words differently.
-.IP [3]
+.IP "[3] \fBWords.\fR"
Words of a command are separated by white space (except for
newlines, which are command separators).
-.IP [4]
+.IP "[4] \fBDouble quotes.\fR"
If the first character of a word is double-quote (``"'') then
the word is terminated by the next double-quote character.
If semi-colons, close brackets, or white space characters
@@ -48,7 +49,7 @@ as ordinary characters and included in the word.
Command substitution, variable substitution, and backslash substitution
are performed on the characters between the quotes as described below.
The double-quotes are not retained as part of the word.
-.IP [5]
+.IP "[5] \fBBraces.\fR"
If the first character of a word is an open brace (``{'') then
the word is terminated by the matching close brace (``}'').
Braces nest within the word: for each additional open
@@ -62,7 +63,7 @@ below, nor do semi-colons, newlines, close brackets,
or white space receive any special interpretation.
The word will consist of exactly the characters between the
outer braces, not including the braces themselves.
-.IP [6]
+.IP "[6] \fBCommand substitution.\fR"
If a word contains an open bracket (``['') then Tcl performs
\fIcommand substitution\fR.
To do this it invokes the Tcl interpreter recursively to process
@@ -74,7 +75,7 @@ substituted into the word in place of the brackets and all of the
characters between them.
There may be any number of command substitutions in a single word.
Command substitution is not performed on words enclosed in braces.
-.IP [7]
+.IP "[7] \fBVariable substitution.\fR"
If a word contains a dollar-sign (``$'') then Tcl performs \fIvariable
substitution\fR: the dollar-sign and the following characters are
replaced in the word by the value of a variable.
@@ -101,7 +102,7 @@ characters whatsoever except for close braces.
There may be any number of variable substitutions in a single word.
Variable substitution is not performed on words enclosed in braces.
.RE
-.IP [8]
+.IP "[8] \fBBackslash substitution.\fR"
If a backslash (``\e'') appears within a word then
\fIbackslash substitution\fR occurs.
In all cases but those described below the backslash is dropped and
@@ -172,14 +173,14 @@ inserted.
Backslash substitution is not performed on words enclosed in braces,
except for backslash-newline as described above.
.RE
-.IP [9]
+.IP "[9] \fBComments.\fR"
If a hash character (``#'') appears at a point where Tcl is
expecting the first character of the first word of a command,
then the hash character and the characters that follow it, up
through the next newline, are treated as a comment and ignored.
The comment character only has significance when it appears
at the beginning of a command.
-.IP [10]
+.IP "[10] \fBOrder of substitution.\fR"
Each character is processed exactly once by the Tcl interpreter
as part of creating the words of a command.
For example, if variable substitution occurs then no further
@@ -200,7 +201,7 @@ set y [set x 0][incr x][incr x]
.CE
will always set the variable \fIy\fR to the value, \fI012\fR.
.RE
-.IP [11]
+.IP "[11] \fBSubstitution and word boundaries.\fR"
Substitutions do not affect the word boundaries of a command.
For example, during variable substitution the entire value of
the variable becomes part of a single word, even if the variable's
diff --git a/generic/tclClock.c b/generic/tclClock.c
index 2d09974..e98eba6 100644
--- a/generic/tclClock.c
+++ b/generic/tclClock.c
@@ -11,7 +11,7 @@
* See the file "license.terms" for information on usage and redistribution
* of this file, and for a DISCLAIMER OF ALL WARRANTIES.
*
- * RCS: @(#) $Id: tclClock.c,v 1.18 2003/01/14 17:51:16 hobbs Exp $
+ * RCS: @(#) $Id: tclClock.c,v 1.19 2003/02/01 19:48:23 kennykb Exp $
*/
#include "tcl.h"
@@ -293,9 +293,12 @@ FormatClock(interp, clockVal, useGMT, format)
/*
* This is a kludge for systems not having the timezone string in
* struct tm. No matter what was specified, they use the local
- * timezone string.
+ * timezone string. Since this kludge requires fiddling with the
+ * TZ environment variable, it will mess up if done on multiple
+ * threads at once. Protect it with a the clock mutex.
*/
+ Tcl_MutexLock( &clockMutex );
if (useGMT) {
CONST char *varValue;
@@ -332,10 +335,16 @@ FormatClock(interp, clockVal, useGMT, format)
Tcl_DStringInit(&buffer);
Tcl_DStringSetLength(&buffer, bufSize);
+ /* If we haven't locked the clock mutex up above, lock it now. */
+
+#if defined(HAVE_TM_ZONE) || defined(WIN32)
Tcl_MutexLock(&clockMutex);
+#endif
result = TclpStrftime(buffer.string, (unsigned int) bufSize,
Tcl_DStringValue(&uniBuffer), timeDataPtr, useGMT);
+#if defined(HAVE_TM_ZONE) || defined(WIN32)
Tcl_MutexUnlock(&clockMutex);
+#endif
Tcl_DStringFree(&uniBuffer);
#if !defined(HAVE_TM_ZONE) && !defined(WIN32)
@@ -349,6 +358,7 @@ FormatClock(interp, clockVal, useGMT, format)
timezone = savedTimeZone;
tzset();
}
+ Tcl_MutexUnlock( &clockMutex );
#endif
if (result == 0) {