  PTC 2.0 C++ API X11 CLASSES Version 2.0.7 (alpha) README
  Christian Nentwich (brn@eleet.mcb.at)
  4/8/1998

  The X11 classes are Copyright (c) 1998 Christian Nentwich
  (brn@eleet.mcb.at) 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.      Missing features

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

  4.      Thankyous

  5.      How to submit bug reports
  ______________________________________________________________________

  1.  Tested platforms

  This version has been compiled and run on the following platforms:

  o  RedHat Linux 5.0, x86 (gcc 2.7.2.3 -O2)

  o  RedHat Linux 5.0, x86 (pgcc 1.0.3a -O6 -mpentium)

  o  RedHat Linux 5.1, x86 (egcs 1.0.2 -O6 -mpentium)

  o  FreeBSD 2.2.7, x86 (gcc 2.7.2.1 -O2)

  In addition, I've successfully compiled it on the following (but I
  couldn't test the display yet, it was compiled in a telnet session):

  o  Irix 6.3, SGI O2 (gcc 2.7.2.1 -O2)

  2.  Missing features

  Missing features means, features missing on my side, no matter what is
  still missing in the platform independent part of PTC:

  o  More Testing

  o  read() does not return any scancode, you can use it to wait for a
     keypress though, and to read from the " keyboard buffer " after
     waiting for key()

  o  Proper documentation for the X11 specific part - continued :)

  Check out BUGS for .. you know what.

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

  The following instructions assume you installed in '/usr/local/',
  which is the default.

  For compiling, everything should be fine, just include "ptc.h" in your
  code.  You might have to add "-I/usr/local/include" to you compiler
  command line if it complains.

  For linking, you need to add the PTC library and all the X libraries
  it used (which are probably going to be linked dynamicly on your
  system). A soft link is made from the current library version to
  libptc.a by the install function, so you just have to use "-lptc".
  Again, you might have to use "-L/usr/local/lib" if your linker doesn't
  search that path by default.

  Example command lines:

  o  Compiling:

       "g++ -c cooleffect.cc -o cooleffect.o -O6 -mpentium
       -I/usr/local/include"

  o  Linking:

       "g++ cooleffect.o -L/usr/X11/lib -lX11 -lXext -lXxf86dga
       -lXxf86vm -lptc -lHermes -o cooleffect"

  I'm assuming that you have your X libraries in /usr/X11/lib and that
  DGA was built in. If not, you can leave the '-lXxf86dga' and
  '-lXxf86vm' out.

  All the path- and filenames above might be different on your system,
  so please check again before complaining :).

  4.  Thankyous

  Handshakes and a pat on the shoulder to the following people for being
  very helpful in identifying problems with PTC X11.

  o  Hilarion (rhogan@mnsi.net)

  o  Nado (nado@ottawa.com)

  o  Ghyll

  5.  How to submit bug reports

  This is an alpha version, don't be surprised if something goes wrong.
  If you don't mind, send an e-mail to brn@eleet.mcb.at 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  XF86Config (or your Metro-X config, or whatever)

  In addition, please run the dumpinfo program you can find in the
  source/static directory and send me the stuff it produces (this is
  quite important):

       source/static/dumpinfo > visual.x11

  It would also be quite useful if you could tell me your compiler
  version and which version of X you are using if it is < R6. I'd be
  forever thankful ;)

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

  Thanks, brn/S!P

