How to install and configure GWXLIBS
====================================

1.  If you plan on compiling GWXLIBS for multiple platforms, and you are
    mounting the source tree from some other machine, you can create a
    directory to hold the current build and then run configure in that
    directory.  For example, in the source directory, make a directory
    called ``osr5'', cd to that directory, and then run ../configure.

    GWXLIBS brings together many different libraries, all of which have a
    plethora of compile time options.  This can make GWXLIBS difficult to
    configure if you want to control the options to a fine degree.  If you
    do, you should edit the glibcfg.h header file before running configure.
    This header file allows you to control all of the configurable options
    in the GWXLIBS packages.  This is a slightly different configuration
    model used in normal autoconf style configuration scripts.

    If you are compiling GWXLIBS in a sub-directory (and not in the main
    source tree), you will need to copy gwxcfg.h into your directory
    before running configure.

2.  Set up gwxoscfg.h.  If your operating system has a specific configuration
    header file, copy it to gwxoscfg.h in the compilation directory. If there
    is no OS specific header file, use generic.os.h. Current OS specific
    header files are:

    osr5.os.h - SCO OpenServer Release 5

3.  If you will be using OpenSSL features in the libraries, make sure that
    you have configured and installed it. See the README file in this
    directory for details. You need to know the prefix of your OpenSSL
    installation when you run the GWXLIBS configure script. GWXLIBS
    expects to find the headers in PREFIX/include/openssl and the
    libraries in PREFIX/lib.

4.  Run the configure script, which should be in the same directory that
    you found this file.  This script will attempt to determine how to build 
    all of the libraries, which libraries to build, and various operating
    system characteristics. If you want to use OpenSSL, you need to
    specify the --with-openssl=PREFIX option, where PREFIX is the prefix
    to your OpenSSL installation.

5.  Take a look at Makefile.top to make sure that the commands and options
    are correct for your platform.  This is the only place you ever need to 
    change compiler or linker flags, as every subsequent Makefile will
    include this file first to get all of its rules and macros.  This file
    is well commented, so please read it and make any required changes.

6.  Run 'make'.  This will build all of the libraries and their support
    programs.  This can take quite a while, so start taking a look at other 
    documentation or get a cup of tea.

7.  Run 'make install'.  This will install everything, and is equivalent to 
    running the following commands:

    make install-libs  (installs all of the actual libraries)
    make install-hdrs  (installs all of the accompanying header files)
    make install-bins  (installs any support programs)
    make install-doc   (installs all documentation and manual pages)

    You can execute any one of these steps in isolation, if you so desire.

    If you are maintaining a package and wish to install to an alternate
    location as opposed to doing a "live" install, set the DESTDIR variable
    to the top of your installation tree. For example, in the directory
    in which you built GWXLIBS, execute:

        mkdir DIST
	make install DESTDIR=`pwd`/DIST

8.  Once everything has been installed, and you are happy with your
    configuration, you can run the command 'make clean'.  This will remove
    all files that were built during the normal compilation process.

What to do if things go wrong
=============================

1.  Try and figure it out for yourself.  This is not rocket science, and
    any problems you encounter should be trvial to fix.

2.  If there is a file called 'BUGS' in the top of the source tree, check
    that.  It will list any known problems and suggest (where possible)
    potential soultions.

3.  Make SURE you have the latest version.  Do not send mail asking for
    help unless you are positive you have the latest version of GWXLIBS.

4.  As a LAST resort, send mail to 'skunkware@sco.com'.  We will try to
    help you as best we can.  Please bare in mind though, we do not have
    access to every possible hardware and software platform, but we will
    try to help you out.
