BUILDING, TESTING, INSTALLING
=============================
Unix
-----
# ./configure
# make
# make check
# make install
Win32
-----
If you use Microsoft Visual C++ (7.1 or later) compiler, you can build
GEOS using NMAKE program and provided makefile.vc files.
If you are building from SVN checkout, first run: autogen.bat
Then:
nmake /f makefile.vc MSVC_VER=1400
where 1400 is version number of Visual C++ compiler, here Visual C++ 8.0
from Visual Studio 2005 (supported versions are 1300, 1310, 1400 and 1500).
The bootstrap.bat step is required to generate a couple of header files.
In order to build debug configuration of GEOS, additional flag DEBUG=1
is required:
nmake /f makefile.vc MSVC_VER=1400 DEBUG=1
CLIENT APPLICATIONS
===================
Using the C interface (recommended)
-----------------------------------
To compile programs against the C lib (recommended):
CFLAGS += `geos-config --cflags`
LDFLAGS += `geos-config --ldflags` -lgeos_c
#include <geos_c.h>
Example usage:
capi/geostest.c contains basic usage
examples.
Using the C++ interface (discouraged)
-------------------------------------
To compile programs against the C++ lib:
CFLAGS += `geos-config --cflags`
LDFLAGS += `geos-config --ldflags` -lgeos
#include <geos.h>
Example usage:
doc/example.cpp contains basic usage
examples.
Scripting language bindings
---------------------------
Ruby bindings are fully supported. To build, use the --enable-ruby option when
configuring:
# ./configure ... --enable-ruby
Since version 3.0, the Python bindings are unsupported. Recommended options:
1. Become or recruit a new maintainer.
2. Use Shapely (http://pypi.python.org/pypi/Shapely) with Python versions 2.4 or greater.
3. Simply call functions from libgeos_c via Python ctypes.
DOCUMENTATION
=============
# cd doc; make doxygen-html
http://trac.osgeo.org/geos