/*
 * @(#)$Header: /mm/src/tgif/v4/gspn2tgif/RCS/README,v 1.0 1999/02/11 15:51:50 william Exp $
 */

This is the ``gspn2tgif'' README file.

Gspn2tgif converts a GreatSPN .def and a .net file to a tgif .obj file.

1) Gspn2tgif is meant to be compiled against the source code of tgif-4.x
   or tgif-3.0.18.  By default, the Imakefile is setup for tgif-4.x
   (Imakefile is identical to Imakefile.4).

   For example, if you have tgif-4.0.13 and if the source code of tgif-4.0.13
   is in ~/src/tgif/tgif-4.0.13, do:

	cd ~/src/tgif/tgif-4.0.13
	make	(<-- must build tgif first)
	gunzip -c gspn2tgif-1.0.0.tar.gz | tar xvf -
	cd gspn2tgif

   If the source code of tgif-3.0.18 is in ~/src/tgif/tgif-3.0.18, do:

	cd ~/src/tgif/tgif-3.0.18
	make	(<-- must build tgif first)
	gunzip -c gspn2tgif-1.0.0.tar.gz | tar xvf -
	cd gspn2tgif
	rm Imakefile
	cp Imakefile.3 Imakefile

   If you don't have tgif, please download tgif source from tgif's download
   link mentioned below.

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@kragen.dnaco.net
                 Mailing List: kragen-tgif@kragen.dnaco.net
          Bug Reports Send To: bill.cheng@acm.org

3) Please copy Gspn2tgif.tmpl-PLATFORM to Gspn2tgif.tmpl (where PLATFORM
   depends on the platform you are on).  For example, if you are on a
   Solaris platform, do:

	rm Gspn2tgif.tmpl
	cp Gspn2tgif.tmpl-solaris Gspn2tgif.tmpl

   The default Gspn2tgif.tmpl is identical to Gspn2tgif.tmpl-linux.  There's
   only a few Gspn2tgif.tmpl-* files in the current release of gspn2tgif.
   More will be added when they become available.  I only have access to
   limited number of platforms, so if you don't find your platform listed,
   please ask a local expert to modify Gspn2tgif.tmpl and send a working
   version to me so I can create new Gspn2tgif.tmpl-* files.

4) Modify the MOREDEFINES line at the beginning of Gspn2tgif.tmpl.

5) Do the following (this is the preferred way of building gspn2tgif),

	xmkmf
	make depend
	make

   If you have imake but, for some reason, 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 depend
	make
6) After gspn2tgif is created, do, for example (assuming that you have
   EsIEEEtr1BACK.def and EsIEEEtr1BACK.net):

	./gspn2tgif EsIEEEtr1BACK

   This will create EsIEEEtr1BACK.obj.  Then you can view it with:

	../tgif EsIEEEtr1BACK