summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorjan.nijtmans <nijtmans@users.sourceforge.net>2016-04-11 10:39:54 (GMT)
committerjan.nijtmans <nijtmans@users.sourceforge.net>2016-04-11 10:39:54 (GMT)
commit6f43610172ef499ef09197cc5e0adf3582360a5c (patch)
tree765f362a28b1996875676e9dea0d596ada815857 /doc
parentee87f2694be353b83f0306ab4bc03225b61b7caf (diff)
downloadtk-6f43610172ef499ef09197cc5e0adf3582360a5c.zip
tk-6f43610172ef499ef09197cc5e0adf3582360a5c.tar.gz
tk-6f43610172ef499ef09197cc5e0adf3582360a5c.tar.bz2
Deprecate Tk_FreeXId(), since it doesn't do anything since 2008-08-19: [8356aa0eec57fa7a]
Diffstat (limited to 'doc')
-rw-r--r--doc/FreeXId.320
1 files changed, 1 insertions, 19 deletions
diff --git a/doc/FreeXId.3 b/doc/FreeXId.3
index 56c7804..84fef26 100644
--- a/doc/FreeXId.3
+++ b/doc/FreeXId.3
@@ -25,24 +25,6 @@ context, or colormap) that is no longer in use.
.BE
.SH DESCRIPTION
.PP
-The default allocator for resource identifiers provided by Xlib is very
-simple-minded and does not allow resource identifiers to be re-used.
-If a long-running application reaches the end of the resource id
-space, it will generate an X protocol error and crash.
-Tk replaces the default id allocator with its own allocator, which
-allows identifiers to be reused.
-In order for this to work, \fBTk_FreeXId\fR must be called to
-tell the allocator about resources that have been freed.
-Tk automatically calls \fBTk_FreeXId\fR whenever it frees a
-resource, so if you use procedures like \fBTk_GetFont\fR,
-\fBTk_GetGC\fR, and \fBTk_GetPixmap\fR then you need not call
-\fBTk_FreeXId\fR.
-However, if you allocate resources directly from Xlib, for example
-by calling \fBXCreatePixmap\fR, then you should call \fBTk_FreeXId\fR
-when you call the corresponding Xlib free procedure, such as
-\fBXFreePixmap\fR.
-If you do not call \fBTk_FreeXId\fR then the resource identifier will
-be lost, which could cause problems if the application runs long enough
-to lose all of the available identifiers.
+This function is deprecated, it doesn't do anything since 2008-08-19.
.SH KEYWORDS
resource identifier