PTC 2.0 C++ API X11 CLASSES Version 2.0.1 (alpha)

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 COPYING.LIB for the exact terms
------------------------------------------------------------------------------

Contents
-----------

  1. Missing features

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

  3. How to submit bug reports




Missing features
-------------------

  Missing features means, features missing on my side, no matter what is  
still missing in the platform independent part of PTC (things like on the
fly conversion):

  - Installation. So far, it only stays in the build directory. (You are
    free to copy the library to /usr/local/lib if you want to use it
    often)

  - Testing. This has only been tested on my machine so far.

  - Display over the net hasn't really been tested.

  - 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()

  - Dynamic library (it's s'posed to be linked statically though in order
    to run on every system)

  - Java interface routines. We want the Java interface under Linux too,
    don't we? I think we do :)

  - Proper documentation for the X11 specific part

Check out BUGS for .. you know what.




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

  Well, first of all, specify the path containing ptc.h as a compiler option,
e.g. 'g++ -c -I~/ptc2.0.0/source foobar.cc'

  When you're done compiling and it comes to linking, you'll have to add a
whole bunch of libraries to your link command, 
e.g 'g++ foobar.o -L/usr/X11/lib -lX11 -lXext -lXxf86dga -lXxf86vm 
     -L~/ptc2.0.0/library/static/release -lptc-2.0.0 -o foobar'

  I'm assuming that you have your X libraries in /usr/X11/lib, and that dga
and vm are available on your system. If not, leave them out, PTC was built
without them anyway (autoconf is clever after all, isn't it :)

  All the path and filenames above might be different on your system, so
please check (especially the library name, depending on the version and the
library path, also depending on the version).

  I will put in a Makefile creator soon to dump these things into a file for
you so things shouldn't be that annoying anymore then.




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):

	config.log
	config.status
	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
  	  Send me visual.x11 then... or
	source/static/dumpinfo | mail brn@eleet.mcb.at
	  if you're online already :)

  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
 
