
This file contains installation instructions specific to Oleo.  Before
reading this file, you should be familiar with the generic
installation instructions in the file INSTALL.

* Compiling X11 support.

If configure finds the header file `<X11/X.h>', Oleo will be compiled
with support X11 in addition to the usual terminal interface.  `-lX11'
will be added to the list of libraries.  

If the X header files are in an unusual location, run configure with a
command like:

  $ DEFS='-I$X_INCLUDE_DIR' configure

If this command is not appropriate for your system, you will have to
edit the Makefile and perhaps the `#include' directives in `io-x11.h'.
In the Makefile, check the defintions of `optional_libs' and
`ALL_CFLAGS'.  To compile without X support, remove `-DHAVE_X11_X_H=1'
from the definition of `ALL_CFLAGS'.  To compile with X11 support,
make sure that HAVE_X11_X_H is defined, and that `optional_libs'
includes the xlib functions.

* System specific advice

** AIX

    A configure bug will require you to remove references to -ltermlib
    from the Makefile on AIX systems.


** Sun

The libm.a for the Sun unbundled compilers conflicts with gcc.  If you
use gcc to compile Oleo, the libm.a distributed with gcc should be
used instead. That means any references to the Sun unbundled products
should be removed from the LD_LIBRARY_PATH envionment variable before
linking oleo.

** SGI

    Apparently the parse.tab.c generated by bison does not include
    alloca.h as it should.  If you have yacc, running `make realclean'
    before `make oleo' will cause all bison output to be rebuilt.

    If you want to use the distributed bison files, edit the cpp conditionals
    that guard `#include <alloca.h>'


** SCO UNIX 3.2v4.0 (These notes are old and may be out of date).

sysdef.h:

commented #include for <sys/select.h>.  time.h already defined struct timeval.

In the makefile, you may need to use these definitions:

        optional_libs =  -lX11_s -lcurses -ltermlib
        libs =  $(optional_libs) -lm -lsocket -lmalloc -lPW -lc_s
