  PTC 2.0 C++ API LibGGI CLASSES Version 2.0.0 (alpha) README
  Jarno Paananen (jpaana@s2.org)
  10/11/1998

  The LibGGI classes are Copyright (c) 1998 Jarno Paananen
  (jpaana@s2.org) The PTC 2.0 C++ API is (c) 1998 Glenn Fiedler
  (ptc@gaffer.org).  This package and all included source code is
  licensed under the GNU LGPL Please refer to the included file COPY-
  ING.LIB for the exact terms (Please read the CHANGES file first if
  you're upgrading!)
  ______________________________________________________________________

  Table of Contents


  1. Tested platforms

  2. Obtaining the newest version and documentation

  3. How to link your own program to PTC 2.0.* X

  4. Thankyous

  5. How to submit bug reports



  ______________________________________________________________________

  1.  Tested platforms

  PTC GGI has been compiled and run on the following platforms:


  o  Debian Linux 2.1 (slink), x86 (egcs-2.91.58 19981101 -O2)


  NOTE: Because the PTC API uses namespaces, older versions of gcc
  and egcs might not be up to the task. Your mileage may vary.


  2.  Obtaining the newest version and documentation

  You can get PTC from:

  o  http://www.gaffer.org/ptc (All platforms, including GGI)

  o  http://www.cs.ucl.ac.uk/students/c.nentwich/ptc (X11)


  You will also find the documentation you require at www.gaffer.org (an
  introduction to PTC, etc.). If you just want the newest PTC X release,
  go to the second homepage, as that's the one that guarantees an up to
  date release.



  3.  How to link your own program to PTC 2.0.* X

  For compiling, you can execute 'ptc-config --cflags' to get all the
  flags you need to build a source file that includes <ptc/ptc.h> (which
  is the only thing you need to include by the way).


  For linking, execute 'ptc-config --libs' to link in PTC, Hermes and
  all the required libraries (LibGGI).

  Example command lines:

  o  Compiling:

       "g++ -c cooleffect.cc -o cooleffect.o `ptc-config --cflags`"


  o  Linking:

       "g++ cooleffect.o -o cooleffect `ptc-config --libs`"




  4.  Thankyous

  The GGI version owes _very_ much to the X11 version (these should
  be merged anyhow on the future) and the Win32 version (new API).
  So thank you very much to Glenn Fiedler and Christian Nentwich.



  5.  How to submit bug reports

  PTC GGI is in alpha stage, so things might (and most probably do ) go
  wrong.. If you don't mind, send an e-mail to jpaana@s2.org if something
  does go wrong and include the following files (check if the bug is know
  first, read the BUGS file):


  o  config.log

  o  config.status

  o  /etc/ggi/libggi.conf

  It would also be quite useful if you could tell me your compiler
  version and LibGGI versions and stuff.

  Then again, if you're bored enough, a patch with a bugfix and comments
  would be cool, send me the diff :)


  Thanks, Jarno Paananen (Guru/Sahara Surfers)
