                  Building and Developing LogConv
                          May 28, 1998

This file describes the steps necessary to compile and link the LogConv code.

LogConv currently compiles with the following environments:

        OS              Compiler and version
     -----------      ------------------------
     DOS/Windows      Watcom 11.0
     Linux            gcc v2.7.2

No matter which platform on which you attempt to compile LogConv make sure that
you enable structure packing.  All of the make and project files should already
have this set properly.

This code has not been compiled on anything other than OS'es running on Intel
compatible machines.  It most likely needs work before it will compile on
Linux machines on top of the Alpha, Power PC, SPARC or 68000 processors.

                            DOS/Windows

The watcom directory contains subdirectories which contain the Watcom 11
projects used to build LogConv for Win32 (GUI and console) and DOS.  To
compile and build LogConv yourself open up the project files from the Watcom
IDE.

You may need to change some of the project settings as they expect to find
the Watcom compiler (and its include files) in the "c:\watcom" directory,
which may differ on your system.

      Directory                  Platform
     -----------             -----------------------------------
     src\watcom\dos          16-bit DOS application
     src\watcom\win32        32-bit Windows GUI application
     src\watcom\win32con     32-bit Windows console application

                               Linux

The Linux version of LogConv is built using a makefile that is located in the
src directory along with the actual LogConv source code.  To build LogConv
merely type in:

     cd src
     make all

                           Known Problems

The DOS version of LogConv is known to be somewhat flakey.  That's the 
reason no optimization or debugging information is enabled in the DOS project
settings.  The program can do some weird things when optimization is in place!
Since I have not been able to properly run the DOS program under debug mode
some inconsistencies have started to creap up between the DOS and Windows/Linux
versions of LogConv.  If you're a good DOS programmer you may be able to
figure out the problem(s) and make the DOS version more stable for other users.
