<PLAINTEXT>
                 Anthony's X Icon Library (version 1.5)
               ------------------------------------------
                       Quick Guide to using icons
               ------------------------------------------

| I wonder if you could write a short description of how one would actually
| use the go.xbm file.  A lot of go players are computer illiterate and I
| personally am X illiterate.  (Well, I've learned a little since I started
| using X 3 months ago, but I don't know what to do with the xbm file.  Maybe
| I'm using the wrong window manager to take advantage of it?)
|
|           --- Adrian Mariano  <adrian@bsdserver.ucsf.edu>


There is a couple of methods.  More information is available in the
other files:   "README.twm"   and   "README.xrdb".

1/ TWM
     get twm to set the icon (this is what I do). To your .twmrc file
   add the following to the appropiate area.

--------------8<-----------CUT HERE--------------8<---------------
#
# Icon Handling
#
IconDirectory  "~/icons"      # where you place your icons for twm to use
UnknownIcon  "unknowen.xbm"   # use this icon if none is supplied
ForceIcons                    # force programs to use icon listed
#
#   The following table causes twm to use certain icons for certain
# windows.  The elements are in pairs of strings the first being either the
# name of the window (EG `xterm-host') OR the class of the application being
# used (EG `XConcole'). The second string is the filename of the icon to
# use and is found either in the above `IconDirectory' or in the
# `*bitmapFilePath' Xresource directorys.   --- Anthony Thyssen  19/7/1993
#
Icons {
  "XIgc"      "go.xbm"
  "XMgt"      "go.xbm"
}
--------------8<-----------CUT HERE--------------8<---------------


2/ Resources
     Add the following to the appropiate clients application default file
   or into a  ~/.Xdefaults  or into a file and use xrdb to merge the
   resources into the server. (read the manuals).  This method has the
   advantage of working on almost all window managers.

  ,--- the clients class name
 v
--------------8<-----------CUT HERE--------------8<---------------
XIgc*iconPixmap:    go.xbm
XMgt*iconPixmap:    go.xbm
--------------8<-----------CUT HERE--------------8<---------------

  This assumes go.xbm is in the current directory or in the
/usr/include/X11/bitmaps  directory. Otherwise you will need to set
the *bitmapFilePath in a resource file, or use a full path in the above.


3/ Program the icon into the application -- this is for the developers.
   NOTE: the developer should insure that they still allow users to
   override their icon default with the appropiate resource.


  Anthony Thyssen - (SysProg @ Griffith University)     anthony@cit.gu.edu.au
------------------------------------------------------------------------------
    The very best, and oldest, computer system built by man is Stonehenge.
    Built by the Druids, who didn`t die out, but went bankrupt trying to 
    debug the software.
------------------------------------------------------------------------------
