README

   1 BUILDING, TESTING, INSTALLING
   2 =============================
   3
   4 Unix
   5 -----
   6
   7         # ./configure
   8         # make
   9         # make check
  10         # make install
  11
  12 Win32
  13 -----
  14
  15 If you use Microsoft Visual C++ (7.1 or later) compiler, you can build
  16 GEOS using NMAKE program and provided makefile.vc files:
  17
  18   bootstrap.bat
  19   nmake /f makefile.vc MSVC_VER=1400
  20
  21 where 1400 is version number of Visual C++ compiler, here Visual C++ 8.0
  22 from Visual Studio 2005 (supported versions are 1300, 1310, 1400 and 1500).
  23 The bootstrap.bat step is required to generate a couple of header files.
  24
  25 In order to build debug configuration of GEOS, additional flag DEBUG=1
  26 is required:
  27
  28   nmake /f makefile.vc MSVC_VER=1400 DEBUG=1
  29
  30
  31 CLIENT APPLICATIONS
  32 ===================
  33
  34 Using the C interface (recommended)
  35 -----------------------------------
  36
  37 To compile programs against the C lib (recommended):
  38
  39         CFLAGS += `geos-config --cflags`
  40         LDFLAGS += `geos-config --ldflags` -lgeos_c
  41         #include <geos_c.h>
  42
  43 Example usage:
  44
  45         capi/geostest.c contains basic usage
  46         examples.
  47
  48 Using the C++ interface (discouraged)
  49 -------------------------------------
  50
  51 To compile programs against the C++ lib:
  52
  53         CFLAGS += `geos-config --cflags`
  54         LDFLAGS += `geos-config --ldflags` -lgeos
  55         #include <geos.h>
  56
  57 Example usage:
  58
  59         doc/example.cpp contains basic usage
  60         examples.
  61
  62
  63 DOCUMENTATION
  64 =============
  65
  66         # cd doc; make doxygen-html
  67
  68         http://trac.osgeo.org/geos
  69