summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authordkf <donal.k.fellows@manchester.ac.uk>2005-12-06 09:16:10 (GMT)
committerdkf <donal.k.fellows@manchester.ac.uk>2005-12-06 09:16:10 (GMT)
commitb05613ae985929afb110379631a7ae942becd611 (patch)
tree7a4b82cb0396932fa212c2312417a871cc4296c7
parent86480885c74b45e5064b4b9fe7ef7fa8a5d5bf0f (diff)
downloadtk-b05613ae985929afb110379631a7ae942becd611.zip
tk-b05613ae985929afb110379631a7ae942becd611.tar.gz
tk-b05613ae985929afb110379631a7ae942becd611.tar.bz2
Doc change to discourage the use of TK_CONFIG_OPTION_SPECIFIED which was not
thread-safe and is now no-longer used.
-rw-r--r--ChangeLog5
-rw-r--r--doc/ConfigWidg.316
2 files changed, 14 insertions, 7 deletions
diff --git a/ChangeLog b/ChangeLog
index bef5787..ddae7c9 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2005-12-06 Donal K. Fellows <donal.k.fellows@manchester.ac.uk>
+
+ * doc/ConfigWidg.3 (TK_CONFIG_OPTION_SPECIFIED): Mentioned that the
+ flag is deprecated because it is not thread-safe.
+
2005-12-05 Reinhard Max <max@suse.de>
* unix/tkUnixEvent.c (OpenIM): Added a workaround to allow at
diff --git a/doc/ConfigWidg.3 b/doc/ConfigWidg.3
index 0aa0ff7..6a6df97 100644
--- a/doc/ConfigWidg.3
+++ b/doc/ConfigWidg.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: ConfigWidg.3,v 1.13 2005/04/06 21:11:53 dkf Exp $
+'\" RCS: @(#) $Id: ConfigWidg.3,v 1.14 2005/12/06 09:16:10 dkf Exp $
'\"
.so man.macros
.TH Tk_ConfigureWidget 3 4.1 Tk "Tk Library Procedures"
@@ -415,12 +415,14 @@ once, save the value, and provide it before calling
\fBTk_ConfigureWidget\fR.
.TP
\fBTK_CONFIG_OPTION_SPECIFIED\fR
-This bit is set and cleared by \fBTk_ConfigureWidget\fR. Whenever
-\fBTk_ConfigureWidget\fR returns, this bit will be set in all the
-entries where a value was specified in \fIargv\fR.
-It will be zero in all other entries.
-This bit provides a way for clients to determine which values
-actually changed in a call to \fBTk_ConfigureWidget\fR.
+This bit is
+.VS 8.5
+deprecated. It used to be set and cleared by \fBTk_ConfigureWidget\fR
+so that callers could detect what entries were specified in
+\fIargv\fR, but it was removed because it was inherently
+thread-unsafe. Code that wishes to detect what options were specified
+should use \fBTk_SetOptions\fR instead.
+.VE 8.5
.PP
The \fBTK_CONFIG_MONO_ONLY\fR and \fBTK_CONFIG_COLOR_ONLY\fR flags are typically
used to specify different default values for