Guide to porting CalTech projects to the gfxtools framework.
------------------------------------------------------------

Prereq: Assumes you have setup your dotfiles as described in the file
$G/shared/man/get-started.txt, so you have $G set in your shell!



1. Copy all the src files for the project and anything else like Makefiles
that should be under CVS (no executables, libs, or binary files!) to a 
temporary dir.

% mkdir /tmp/foo
% cp *.C /tmp/foo
% cp Makefile /tmp/foo
% etc..

According to dhl, the best way to do this is to start from the latest
version of source files in the Caltech source control tree.  Here's
one way to do that, with "foo" as the example package (it assumes that 
you have the old caltech tools available in your path):

% mkdir -p /tmp/graphics/src/sun/foo	# make a working directory
% cd /tmp/graphics/src/sun/foo		#   with caltech naming
					#   conventions
% Sgetsrc				# gets out the latest version



2. Goto /tmp/foo and import the project into the gfxtools cvs repository.
Replace project-name below with the name of the caltech project, libgg,
for example.

% cd /tmp/foo		# (or /tmp/graphics/src/sun/foo)
% gfxprojinit project-name .



3. cd to the project under $G/src if it's not already there, you can
check it out with "cvs up -d project-name"


4. Edit the Makefile.

replace    include /usr/graphics/lib-shared/Make.rules
with       include $(G)/lib/Make.gg.rules



5. Try compiling.. 

% make

(if you have the old caltech stuff in your path, you may need to use
/usr/bin/make explicitly)

Note that for many of the packages there are test programs that start
with "t", "thash.C", for example, in the libds directory.  Getting
those to build and run will often tease out potential problems.

6. Install the library/project with Sinstall.  There is a script
$G/bin/Sinstall that replaces the CalTech version of Sinstall.
It reads the same Sifile in the project directory, but reinterprets it
for the $G structure and calls gfxinstall3
to install it correctly.

Sinstall  OR  make install (for most projects)