-------------------------------------------------------------------------------

OpenPTC 1.0 C++ API GGI CLASSES Version 1.0.0 README
Copyright (C) 1999 giles francis hall
5.3.99

The GGI classes are Copyright (c) 1999 giles francis hall
(ghall@csh.rit.edu) 

The OpenPTC 1.0 C++ API is (c) 1998/99 Glenn Fiedler (ptc@gaffer.org).

Portions of the code and documentation are shamelessly stolen from Christian
Nentwich (c.nentwich@cs.ucl.ac.uk). 

This package and all included source code is licensed under the GNU LGPL
Please refer to the included file COPYING for the exact terms.


-------------------------------------------------------------------------------

WARNING

This code is /very/ alpha.  I would not recommend using this code to
generate graphics for the big board in your war room.  Regardless, if you
choose not to heed my warning and lose some large nuclear war because of
some nasty bug, YOU CAN HOLD ME LIABLE (but, I would advise you file a bug
report).  The following code is provided as-is with /no/ warranty what so
ever!

-------------------------------------------------------------------------------

Bravo.  Thank you.  Mad props.

Glenn Fiedler - For providing the community with OpenPTC and the ptc-porting
kit.  Your contributions have only made the world a better place. 

Christian Nentwich - For his amazing development skills.  Your X11 code
provided an awesome model to follow.  Hermes is some fly shit!

Jarno Paananen - For providing the first GGI port.  Your code was crucial to
introducing me to GGI.  I hope you will help me import this port.

-------------------------------------------------------------------------------

What is GGI?  Check out http://www.ggi-project.org

-------------------------------------------------------------------------------


What?  Your demos core dumped as soon as you ran them?  Well, have you tried
setting your LD_LIBRARY_PATH?  No?  Well, try it and see if that works. 
Try the following:

'export LD_LIBRARY_PATH=`pwd`/library' (bourne)

	- or - 

'setenv LD_LIBRARY_PATH `pwd`/library' (cshell) 

from the root of the distribution.  If that doesn't work, then try doing a
'make install'.  And, if /that/ doesn't work, then you may have found a bug. 
Try compiling the library with debugging symbols (-g) and see where you are
dumping core.

Now, I bet you were looking for some /real/ documentation in here.  Well,
there really isn't any yet.  Sorry.

Expect more in the next week or so.

-giles francis hall
 <ghall@csh.rit.edu>