NAME

       Tk_FreeXId - make X resource identifier available for reuse

SYNOPSIS

       #include <tk.h>

       Tk_FreeXId(display, id)

ARGUMENTS

       Display *display (in)          Display for which id was allocated.

       XID id (in)                    Identifier  of X resource (window, font, pixmap, cursor, graphics context,
                                      or colormap) that is no longer in use.
________________________________________________________________________________________________________________

DESCRIPTION

       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, Tk_FreeXId must be called
       to tell the allocator about resources that have been freed.  Tk automatically calls  Tk_FreeXId  whenever
       it  frees  a resource, so if you use procedures like Tk_GetFont, Tk_GetGC, and Tk_GetPixmap then you need
       not call Tk_FreeXId.  However, if you allocate resources directly  from  Xlib,  for  example  by  calling
       XCreatePixmap,  then you should call Tk_FreeXId when you call the corresponding Xlib free procedure, such
       as XFreePixmap.  If you do not call Tk_FreeXId then the resource identifier will  be  lost,  which  could
       cause problems if the application runs long enough to lose all of the available identifiers.

KEYWORDS

       resource identifier