_________________________________________________________________



NAME

     Tutil_AtomInit,
     Tutil_FindAtom,
     Tutil_RegisterAtom,
     Tutil_UnregisterAtom

       - associate ClientData with atoms (aka "handles")


SYNOPSIS

     int
     Tutil_AtomInit (interp)

     int
     Tutil_RegisterAtom (interp, atom, clientData)

     void
     Tutil_UnregisterAtom (interp, atom)

     ClientData
     Tutil_FindAtom (interp, atom)


ARGUMENTS

     Tcl_Interp   *interp      (in)      Tcl interpreter.

     char         *atom        (in)      The atom name.

     ClientData   clientData   (in)      The  ClientData  associ-
                                         ated with the atom.

_________________________________________________________________



DESCRIPTION

     The above utility procedures provide a  mapping  from  atoms
     (also  known as "handles") to ClientData's.  File descriptor
     handles (such as returned  by  the  Tcl  open  command)  are
     implicitly registered.

     The procedure Tutil_AtomInit initializes the atom to Client-
     Data mapping package and should be called first.


AUTHOR

     Brian Smith (bsmith@cs.berkeley.edu)
     Steve Yen (syen@cs.berkeley.edu)