CHMLIB 0.3 Installation
=======================

Linux
-----
1. Edit the Makefile (yeah, yeah, I know...  it's archaic and I should be
   using automake or something...).  There are not many settings you need to
   modify here.  Basically, there are three defines you may want to modify:

   CHM_MT:              build library with synchronization for thread-safety
   CHM_USE_PREAD:       use pread instead of lseek/read
   CHM_USE_IO64:        support 64-bit file I/O

   Modify the INSTALLPREFIX to change the installation location.

2. make

3. su
   make install

To use the library, see chm_lib.h, and the included example programs:

    test_chmLib.c
    enum_chmLib.c
    chm_http.c

Windows
-------
1. Open up the ChmLib.dsw file in Developer Studio.  (This was developed on
   Developer Studio 6.  I don't know if that matters.)  You may wish to enable
   or disable certain features by adding preprocessor defines under the project
   settings dialog:

   CHM_MT:              build library with synchronization for thread-safety

   CHM_MT is enabled by default in the Windows build.

2. build

3. The library is called chmlib.lib.

The workspace includes all of the examples except for chm_http.  I don't know
enough about Windows network programming to try to get that one working.  Other
than that one, all the other examples run without any problems.

Sparc (Solaris)
---------------
    Andrew Hodgetts has gotten the library compilable and working on Sparc
Solaris machines, with CPUs ranging from a Sun4m (Sparc5) up through an
UltraSparcIII (SunFireV880).  He has managed the compilation using both GCC and
SunProC, although, he notes, some modification to the Makefile was required,
since SunProC does not understand the -fPIC flag, which GCC uses for Position
Independent Code.

MIPS (SGI Irix)
---------------
    Andrew Hodgetts has gotten the library compilable and working on SGI MIPS
machines running Irix; this was using only the standard MIPS compiler, not GCC.
He reported that the -n32 flag was required in the Makefile.  He also reported
that the MIPS compiler was fairly verbose with the warning messages, but that
the simple examples that came with the library seemed to work.

Other Unix variants
-------------------
    The code has been written with an eye on portability.  Presently, I've only
personally compiled on Linux and Windows, albeit on a variety of Linux
configurations, but, as reported above, Andrew Hodgetts has reported successful
use of the library on both Solaris machines and MIPS machines..  After I get
version 0.3 out, I may try to get it compiling on some of the machines I have
at work.  This code may or may not compile out of the box with, for instance,
*BSD or other Unix variants.  I welcome any patches that increase the
portability of this code.

    Platforms that I have access to at work, and may attempt to support after
version 0.3:

        - AIX
        - MacOS X
        - maybe Tru64