WHAT IT IS
----------

Pigment-python contains modules that allow you to use Pigment in Python
programs. At present, it is a fairly complete set of bindings.

WHERE TO START
--------------

We have a development website at https://code.fluendo.com/pigment/trac
You can subscribe to our mailing lists; see the website for details.
We track bugs in Trac on the website.
You can join us on IRC at #pigment on irc.freenode.org

PLATFORMS
---------

- Linux is *of course* fully supported.
- MacOSX is supported, using the autotools.
- Windows is supported, see the win32/README.txt file for more information.

INSTALLING FROM PACKAGES
------------------------

You should always prefer installing from packages first. There are Pigment
packages for a number of distributions, including Fedora, Debian, Ubuntu,
Mandrake, Gentoo, etc.

Only in cases where you:
- want to hack on pigment-python
- want to verify that a bug has been fixed
- do not have a sane distribution
should you choose to build from source tarballs or SVN.

COMPILING FROM SVN
------------------

To build pigment-python from repository source code, you also need pigment
from the repository since it hardly depend on it. The pgm-uninstalled script
setup all the environment for you and avoid installing file system-wide.
Simply do something like this:

  svn co https://code.fluendo.com/pigment/svn/trunk pigment
  cd pigment/pigment
  ./pigment/misc/pgm-uninstalled
  ./autogen.sh
  make
  cd ../pigment-python
  ./autogen.sh
  make

BUILD DEPENDENCIES
------------------

Ubuntu Feisty, Gutsy & Hardy:

  Core dependencies:
  - autoconf
  - automake1.7
  - libglib2.0-dev
  - libgtk2.0-dev
  - libgstreamer0.10-dev
  - libgstreamer-plugins-base0.10-dev
  - python2.5-dev
  - python-gobject-dev
  - python2.5-gst0.10
  Optional dependencies:
  - python-xml if the --enable-docstrings ./configure option is used
