*********************** README *******************************

LibGGI2d is a quite complex piece of software, so be sure 
to read this before blindly typing make (you have already 
done so, right ?).

More problems often result from the threads package. Common 
symptoms are the compile failing in some threads-related .h 
file (there is a typo in a very common package - I just 
don't remember what it was) or the demos not starting up 
but hanging around.

In these cases try to build with 'make THREADS=NO' or placing
THREADS=NO in the Makefile.  Note that this is required for 
now for OpenBSD until Todd Fries has time to investigate 
threads.

One particular case where you should do this, is when using 
the X target. 
X libraries need to be specifically built to support threads.  
Most current distributions do not have these libs.
Thanks to Michael Krause there is a binary package with
thread-enabled Xlibs out there for us :
http://ms.demo.org/rst/threadedxlibs.tar.gz

If you want to do it yourself, there are patches for XFree 
that come with linuxthreads sources.

ftp://ftp.redhat.com/pub/home/sopwith/xfree/        
has rpms of a patched XFree 3.2

Another recently discovered incompatibility comes up when 
using glibc together with libdl. Make sure libdl is updated 
to libdl.2 (which comes with glibc as I am told) and the 
apps are actually bound with it (use ldd if in doubt). 
The symptom for this problem is the apps segfaulting at 
startup.

In case you experience further problems, you might consider 
looking at the following

  Environment variables:  

    DISPLAY          - if set, assumes you want to use the X11R6
                       display driver. Can be overriden by the
                       LIBGGI_DISPLAY variable.

    GGI_DISPLAY      - default display driver
                       (if not present, GGI will use a suitable default)

    GGI2D_DEBUG      - debug level for libggi2d
                       0     - debugging is off
                       1-254 - undefined
                       255   - all debugging flags are on

