summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authornijtmans <nijtmans>2008-11-12 00:15:24 (GMT)
committernijtmans <nijtmans>2008-11-12 00:15:24 (GMT)
commit08822bfc3683f6f3b0af04540c55847ed2b0ecd9 (patch)
tree3da7e649cc710d08d3e62832325e86accb99fa4d /doc
parentb230027f2cb9e767a33e63b1d09831b32431c38a (diff)
downloadtk-08822bfc3683f6f3b0af04540c55847ed2b0ecd9.zip
tk-08822bfc3683f6f3b0af04540c55847ed2b0ecd9.tar.gz
tk-08822bfc3683f6f3b0af04540c55847ed2b0ecd9.tar.bz2
modify Tk_Create(Old)ImageType signature, relaxing
the constraint that every Tk_ImageType can only be passed to this function once. This allows tkImg to be loaded in multiple interpreters in a thread-enabled build of Tk. This CONSTification complies with TIP #27. It is binary compatible with the old interface, but not fully source compatible (although tkImg does not suffer).
Diffstat (limited to 'doc')
-rw-r--r--doc/CrtImgType.311
1 files changed, 6 insertions, 5 deletions
diff --git a/doc/CrtImgType.3 b/doc/CrtImgType.3
index 5b074d2..2505272 100644
--- a/doc/CrtImgType.3
+++ b/doc/CrtImgType.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: CrtImgType.3,v 1.15 2008/11/09 23:16:56 nijtmans Exp $
+'\" RCS: @(#) $Id: CrtImgType.3,v 1.16 2008/11/12 00:15:26 nijtmans Exp $
'\"
.so man.macros
.TH Tk_CreateImageType 3 8.5 Tk "Tk Library Procedures"
@@ -23,11 +23,12 @@ ClientData
.sp
\fBTk_InitImageArgs\fR(\fIinterp, argc, argvPtr\fR)
.SH ARGUMENTS
-.AS Tk_ImageType *typePtrPtr
-.AP Tk_ImageType *typePtr in
+.AS "const Tk_ImageType" *typePtrPtr
+.AP "const Tk_ImageType" *typePtr in
Structure that defines the new type of image.
-Must be static: a
+For Tk 8.4 and earlier this must be static: a
pointer to this structure is retained by the image code.
+In Tk 8.5, this limitation was relaxed.
.AP Tcl_Interp *interp in
Interpreter in which image was created.
.AP "const char" *name in
@@ -113,7 +114,7 @@ typedef int \fBTk_ImageCreateProc\fR(
const char *\fIname\fR,
int \fIobjc\fR,
Tcl_Obj *const \fIobjv\fR[],
- Tk_ImageType *\fItypePtr\fR,
+ const Tk_ImageType *\fItypePtr\fR,
Tk_ImageMaster \fImaster\fR,
ClientData *\fImasterDataPtr\fR);
.CE