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

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

First of all make sure you have all the REQUIRED_SOFTWARE 
(see the file which is named so).
Basically the only unusual components which are often not 
present or not installed correctly are linuxthreads and/or 
libdl (if applicable).

Moreover you should have made sure the rest of the KGI 
system is working properly (though from this distribution 
on, libggi should build even without KGI installed). 
A make install in the toplevel dir of the GGI distribution 
might be advisable ...

On some systems dynamic libraries are not installed correctly 
which causes unnecessary bloat due to static linkling or even 
failing linking.

Dynamic libs are often only existent as lib*.so.num, but 
not as lib*.so without further suffixes. While this 
suffices for running prebuilt binaries,it is not sufficient 
for building new ones. Please check this common problem
when the linker barfs at you or ldd doesn't give the 
results you expected.

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.

    LIBGGI_DISPLAY   - default display driver
                       (if not present, "display-KGI:/dev/graphic"
                        is used)

    LIBGGI_DEBUG     - debug level for libggi and associated libs
                       0     - debugging is off
                       1-254 - undefined
                       255   - all debugging flags are on
