summaryrefslogtreecommitdiffstats
path: root/doc/ConfigWidg.3
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 /doc/ConfigWidg.3
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.
Diffstat (limited to 'doc/ConfigWidg.3')
-rw-r--r--doc/ConfigWidg.316
1 files changed, 9 insertions, 7 deletions
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