INSTALL

   1 Compatibility notes
   2 ===================
   3
   4 GCC 2.95.2 seems to lack the 'sstream' header file required
   5 to build GEOS. GCC 2.96 is known to work.
   6
   7 Quickstart
   8 ==================
   9
  10 As root:
  11
  12    ./configure
  13    make
  14    make install
  15
  16 The default install location for GEOS is /usr/local.
  17
  18 Linux: Make sure that /usr/local/lib is added to /etc/ld.so.conf
  19        Make sure that you run /sbin/ldconfig afterwards
  20
  21 Solaris: Make sure that /usr/local/lib is added to LD_LIBRARY_PATH
  22
  23
  24 Basic Installation
  25 ==================
  26
  27 The simplest way to compile this package is:
  28
  29
  30   1. `cd' to the directory containing the package's source code and type
  31      `./configure' to configure the package for your system.  If you're
  32      using `csh' on an old version of System V, you might need to type
  33      `sh ./configure' instead to prevent `csh' from trying to execute
  34      `configure' itself.
  35
  36      Running `configure' takes awhile.  While running, it prints some
  37      messages telling which features it is checking for.
  38
  39   2. Type `make' to compile the package.
  40
  41   3. Optionally, type `make check' to run any self-tests that come with
  42      the package.
  43
  44   4. Type `make install' to install the programs and any data files and
  45      documentation.
  46
  47   5. You can remove the program binaries and object files from the
  48      source code directory by typing `make clean'.  To also remove the
  49      files that `configure' created (so you can compile the package for
  50      a different kind of computer), type `make distclean'.  There is
  51      also a `make maintainer-clean' target, but that is intended mainly
  52      for the package's developers.  If you use it, you may have to get
  53      all sorts of other programs in order to regenerate files that came
  54      with the distribution.
  55
  56
  57 Compilers and Options
  58 =====================
  59
  60    Some systems require unusual options for compilation or linking that
  61 the `configure' script does not know about.  You can give `configure'
  62 initial values for variables by setting them in the environment.  Using
  63 a Bourne-compatible shell, you can do that on the command line like
  64 this:
  65      CC=c89 CFLAGS=-O2 LIBS=-lposix ./configure
  66
  67 Or on systems that have the `env' program, you can do it like this:
  68      env CPPFLAGS=-I/usr/local/include LDFLAGS=-s ./configure
  69
  70
  71 Installation Names
  72 ==================
  73
  74    By default, `make install' will install the package's files in
  75 `/usr/local/bin', `/usr/local/man', etc.  You can specify an
  76 installation prefix other than `/usr/local' by giving `configure' the
  77 option `--prefix=PATH'.
  78
  79
  80 Operation Controls
  81 ==================
  82
  83 `configure' recognizes the following options to control how it
  84 operates.
  85
  86 --cache-file=FILE
  87      Use and save the results of the tests in FILE instead of
  88      `./config.cache'.  Set FILE to `/dev/null' to disable caching, for
  89      debugging `configure'.
  90
  91 --help
  92      Print a summary of the options to `configure', and exit.
  93
  94 --quiet
  95 --silent
  96 -q
  97      Do not print messages saying which checks are being made.  To
  98      suppress all normal output, redirect it to `/dev/null' (any error
  99      messages will still be shown).
 100
 101 --srcdir=DIR
 102      Look for the package's source code in directory DIR.  Usually
 103      `configure' can determine that directory automatically.
 104
 105 --version
 106      Print the version of Autoconf used to generate the `configure'
 107      script, and exit.
 108
 109 --prefix
 110      Change the default installation location
 111
 112 `configure' also accepts some other, not widely useful, options.