summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorjan.nijtmans <nijtmans@users.sourceforge.net>2023-11-16 11:08:53 (GMT)
committerjan.nijtmans <nijtmans@users.sourceforge.net>2023-11-16 11:08:53 (GMT)
commit05ff9d164e5127a86cf2e93236624193fef3135e (patch)
tree0d39abd55de131708e2931a440227cecbe4ea94b /doc
parentb571874acdb6907f92b4bc630a8c5db172a771a8 (diff)
downloadtk-05ff9d164e5127a86cf2e93236624193fef3135e.zip
tk-05ff9d164e5127a86cf2e93236624193fef3135e.tar.gz
tk-05ff9d164e5127a86cf2e93236624193fef3135e.tar.bz2
Remove some (very old!) Image-related stuff, and unused stub entries
Diffstat (limited to 'doc')
-rw-r--r--doc/ConfigWidg.38
-rw-r--r--doc/CrtImgType.322
-rw-r--r--doc/CrtPhImgFmt.339
3 files changed, 0 insertions, 69 deletions
diff --git a/doc/ConfigWidg.3 b/doc/ConfigWidg.3
index e29daa8..6fa6de4 100644
--- a/doc/ConfigWidg.3
+++ b/doc/ConfigWidg.3
@@ -429,14 +429,6 @@ to process the default string: the client can compute the default
once, save the value, and provide it before calling
\fBTk_ConfigureWidget\fR.
.TP
-\fBTK_CONFIG_OPTION_SPECIFIED\fR
-This bit is
-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.
-.PP
The \fBTK_CONFIG_MONO_ONLY\fR and \fBTK_CONFIG_COLOR_ONLY\fR flags are typically
used to specify different default values for
monochrome and color displays. This is done by creating two
diff --git a/doc/CrtImgType.3 b/doc/CrtImgType.3
index b0a14fc..b1f03dd 100644
--- a/doc/CrtImgType.3
+++ b/doc/CrtImgType.3
@@ -255,28 +255,6 @@ typedef int \fBTk_ImageCreateProc\fR(
Tk_ImageModel \fImodel\fR,
ClientData *\fImodelDataPtr\fR);
.CE
-Legacy programs and libraries dating from those days may still
-contain code that defines extended Tk image types using the old
-interface. The Tk header file will still support this legacy
-interface if the code is compiled with the macro \fBUSE_OLD_IMAGE\fR
-defined.
-.PP
-When the \fBUSE_OLD_IMAGE\fR legacy support is enabled, you may
-see the routine \fBTk_InitImageArgs\fR in use. This was a migration
-tool used to create stub-enabled extensions that could be loaded
-into interps containing all versions of Tk 8.1 and later. Tk 8.5 no longer
-provides this routine, but uses a macro to convert any attempted
-calls of this routine into an empty comment. Any stub-enabled
-extension providing an extended image type via the legacy interface
-that is compiled against Tk 8.5 headers and linked against the
-Tk 8.5 stub library will produce a file that can be loaded only
-into interps with Tk 8.5 or later; that is, the normal stub-compatibility
-rules. If a developer needs to generate from such code a file
-that is loadable into interps with Tk 8.4 or earlier, they must
-use Tk 8.4 headers and stub libraries to do so.
-.PP
-Any new code written today should not make use of the legacy
-interfaces. Expect their support to go away in Tk 9.
.SH "SEE ALSO"
Tk_ImageChanged, Tk_GetImage, Tk_FreeImage, Tk_RedrawImage, Tk_SizeOfImage
.SH KEYWORDS
diff --git a/doc/CrtPhImgFmt.3 b/doc/CrtPhImgFmt.3
index c7accdb..03a4046 100644
--- a/doc/CrtPhImgFmt.3
+++ b/doc/CrtPhImgFmt.3
@@ -457,45 +457,6 @@ typedef int \fBTk_ImageStringWriteProc\fR(
Tcl_Obj *\fIformat\fR,
Tk_PhotoImageBlock *\fIblockPtr\fR);
.CE
-.PP
-.SH "LEGACY INTERFACE SUPPORT"
-.PP
-In Tk 8.2 and earlier, the definition of all the function pointer
-types stored in fields of a \fBTk_PhotoImageFormat\fR struct were
-incompatibly different. Legacy programs and libraries dating from
-those days may still contain code that defines extended Tk photo image
-formats using the old interface. The Tk header file will still support
-this legacy interface if the code is compiled with the
-macro \fBUSE_OLD_IMAGE\fR defined. Alternatively, the legacy interfaces
-are used if the first character of \fIformatPtr->name\fR is an
-uppercase ASCII character (\fBA\fR-\fBZ\fR), and explicit casts
-are used to forgive the type mismatch. For example,
-.CS
-static Tk_PhotoImageFormat myFormat = {
- "MyFormat",
- (Tk_ImageFileMatchProc *) FileMatch,
- NULL,
- (Tk_ImageFileReadProc *) FileRead,
- NULL,
- NULL,
- NULL
-};
-.CE
-would define a minimal \fBTk_PhotoImageFormat\fR that operates provide
-only file reading capability, where \fBFileMatch\fR and \fBFileRead\fR
-are written according to the legacy interfaces of Tk 8.2 or earlier.
-.PP
-Any stub-enabled extension providing an extended photo image format
-via the legacy interface enabled by the \fBUSE_OLD_IMAGE\fR macro
-that is compiled against Tk 8.5 headers and linked against the
-Tk 8.5 stub library will produce a file that can be loaded only
-into interps with Tk 8.5 or later; that is, the normal stub-compatibility
-rules. If a developer needs to generate from such code a file
-that is loadable into interps with Tk 8.4 or earlier, they must
-use Tk 8.4 headers and stub libraries to do so.
-.PP
-Any new code written today should not make use of the legacy
-interfaces. Expect their support to go away in Tk 9.
.SH "SEE ALSO"
Tk_FindPhoto, Tk_PhotoPutBlock
.SH KEYWORDS