HOWTO Get XCB (and) Cairo Running
=================================

Felix Rabe <public@felixrabe.textdriven.com>, 21 April 2008.
Placed in the public domain, copyright law is not enforced on this text.

Quick
-----

Just copy&paste and (DISCLAIMER: NO WARRANTY) run.  If anything goes wrong,
read on below.

========================================================================
#!/bin/sh
export SRC="$HOME/src/xcb-cairo"
export PREFIX="$HOME/opt/xcb-cairo"

mkdir -p "$SRC"

clone_and_build() {
    gitroot=git://anongit.freedesktop.org/git
    gitpath=$1
    shift
    echo
    echo "  * Getting $gitroot/$gitpath"
    echo
    cd "$SRC"
    mkdir -p `dirname $gitpath`
    cd `dirname $gitpath`
    git-clone $gitroot/$gitpath
    echo
    echo "  * Building $gitpath"
    echo
    cd `basename $gitpath`
    ./autogen.sh --prefix="$PREFIX" "$@" && \
        make && make install && \
        echo && echo "  * Building $gitpath was successful"
}

clone_and_build xorg/util/macros

export ACLOCAL="aclocal -I $PREFIX/share/aclocal"
export PKG_CONFIG_PATH="$PREFIX/lib/pkgconfig"
export PYTHONPATH="$PREFIX/lib/python2.5/site-packages"

clone_and_build xorg/lib/libXau
clone_and_build xorg/proto/x11proto
clone_and_build xorg/lib/libXdmcp

clone_and_build xcb/pthread-stubs
clone_and_build xcb/proto
clone_and_build xcb/libxcb
clone_and_build xcb/util
clone_and_build xcb/demo

clone_and_build pixman
clone_and_build cairo --enable-xcb
========================================================================


Remarks
-------

Cairo's sources contain the 'INSTALL' file:
    http://gitweb.freedesktop.org/?p=cairo;a=blob_plain;f=INSTALL
This will guide you through the Cairo compilation and installation once all
the required software (XCB + others) is in place.  IIRC, I had to install
automake, autoconf, libtool, git, various-xorg-stuff-dev beforehand.

Consult these documents for more information: (can be out of date)
    http://xcb.freedesktop.org/DevelopersGuide/
    http://xorg.freedesktop.org/wiki/ModularDevelopersGuide