/*
 * Author:	William Chia-Wei Cheng (william@cs.ucla.edu)
 *
 * @(#)$Header: /u/halfmoon/home/william/src/tgif/v3/RCS/README,v 3.2 1998/11/06 17:08:21 william Exp $
 */

This is the ``tgif'' README file.  Tgif is pronounced, "T-G-I-F".

Tgif is an Xlib base 2-D drawing facility under X11.

1) Please read the "Copyright" file in this distribution for the copyright
   and licensing information.

2) Tgif resources:

                    Home Page: http://bourbon.cs.umd.edu:8001/tgif/
                          FAQ: http://bourbon.cs.umd.edu:8001/tgif/faq/
   Current Release & Download: http://bourbon.cs.umd.edu:8001/tgif/current.html
         Join to Mailing List: kragen-tgif-subscribe@gentle.dyn.ml.org
                 Mailing List: kragen-tgif@gentle.dyn.ml.org
          Bug Reports Send To: bill.cheng@acm.org

2) Please read tgif.man, the man pages that comes with the distribution.
	nroff -t -man tgif.man | more	<== to view
	psroff -man tgif.man		<== to print

3) Modify Makefile.noimake or Imakefile such that TGIF_PATH is set to
   the directory where the optional icon file will be.

4) Modify the DEFINES line at the beginning of Imakefile or Makefile.noimake
   (see "Things to try..." in the Imakefile for examples).  Please do not
   change -DTELEPORT_ATTR=\"warp_to=\", -DLAUNCH_ATTR=\"launch=\", or
   -DEXEC_ATTR=\"exec=\".

5) If you have imake and xmkmf, do the following (this is the preferred way
   of building tgif),
	xmkmf
	make tgif

   If you don't have imake, just do the following,
	cp Makefile.noimake Makefile
	make tgif

   If you have imake but don't have xmkmf, do the following,
		(note that the config directory should be set to
		wherever you can find Imake.tmpl)
	imake -DUseInstalled -I/usr/local/libdata/X11/config
	make tgif

6) If your <Meta> key does not work on a HP-UX machine, try doing the following
   (<Meta> is also labeled <Alt> on some keyboards):

   xmodmap -e "clear mod1"
   xmodmap -e "add mod1 = Meta_L Meta_R"

7) Please also note that tgif has nothing to do with GIF files/formats.
