PrimaGIS buildout for Debian based systems
=====================================

A large part of PrimaGIS's dependencies can be satisfied with system
packages which will dramatically reduce the time to execute the
buildout. This document describes the process of using system packages
on a Debian based Linux distribution.

Supported distributions
-----------------------

The buildout is known to work on the following distributions:

 - Debian unstable (sid)
 - Debian 4.0 (etch)
 - Ubuntu 7.04

It may also work on other distributions that provide the same set of
packages.


Required packages
-----------------

Below is a list of packages that need to be installed before executing
the buildout:

  libpng-dev
  libungif4-dev
  libjpeg-dev
  libtiff-dev
  libfreetype6-dev
  libgd2-noxpm-dev | libgd2-xpm-dev
  libcurl3-gnutls-dev
  libz-dev
  libreadline-dev
  libgdal-dev
  libgeos-dev
  libxerces27-dev
  swig
  bison
  flex
  sed
  build-essential
  python-gdal
  python-psycopg2
  python-imaging
  python-elementtree | python-celementtree
  python2.4-dev
  autoconf
  automake

----------
You can run(Tested on Ubuntu 7.04):

sudo apt-get install libpng-dev libungif4-dev libjpeg-dev libtiff-dev libfreetype6-dev libgd2-noxpm-dev libcurl3-gnutls-dev libz-dev libreadline-dev libgdal-dev libgeos-dev swig bison flex sed build-essential python-gdal python-psycopg2 python-imaging python-elementtree python2.4-dev autoconf automake libxerces27-dev

If you have non-standard repositories you may need to adjust the package names to specific versions.

Example Error and Fix:
Package libpng-dev is a virtual package provided by:
  libpng12-dev 1.2.15~beta5-1ubuntu1
You should explicitly select one to install.

Change libpng-dev to libpng12-dev in the apt-get command above

----------

This list of packages will pull in the rest of the requirements
through their dependencies.

If you are familiar with your distribution's packaging system you may
swap a package with another as long as it provides the same basic
functionality, e.g. changing libgd's noxpm version with the xpm
version.


Running the buildout
--------------------

The buildout is run by:

  $ ./bin/buildout -c buildout-deb.cfg

It is important to use the debian specific buildout configuration
using the -c switch. This will use the system libraries instead of
building everything by hand.

Please refer to README.txt for further instructions. They apply to the
debian buildout with the exception of the buildout invocation given
above.