# Copyright 2010 Dirk Wallenstein
X-JHBuild is a framework for building and working with X.org modules.
It makes use of JHBuild and is specialized for working with modules that
use Git as VCS.
The goal is to let a user easily build a complete set of bleeding edge modules,
but it also offers a lot of possibilities for customization, to ease up
This is work in progress, and until there is nice documentation, you are
encouraged to rummage through the commit messages, release mails, and
help output of subcommands.
A Git version >= 1.7 is recommended. Otherwise, it is not possible to use the
sign in the prompt, the navigation helper, and the CWD-Module adaption.
A Python-2 version >= 2.6 is required.
To install X-JHBuild and private versions of JHBuild  and Git-Python 
execute the following commands:
$> git clone git://x-jhbuild.git.sourceforge.net/gitroot/x-jhbuild/x-jhbuild
$> cd x-jhbuild
$> make install
It creates ~/.x-jhbuild where it is possible to customize global aspects of
X-JHBuild. The '.internal' subdirectory is a temporary installation location --
files in there will be overwritten and possibly wiped out when updating
The main script must be accessible in PATH. It's located at:
There are useful shell helpers in:
If all you want is to quickly build all bleeding edge X.org modules, just
navigate to a (possibly new) directory where you want to have all the sources
If you want to build the xorg-server and all drivers, while following the
progress in a nice HTML log, execute the following:
xjh tinderwrap start xorg-drivers
Get main help and a list of all X-JHBuild subcommands:
Get a list of all JHBuild subcommands (this only works in an initialized
All subcommands support the -h/--help options:
xjh <subcommand> -h
This is work in progress and in particular the documentation will improve in
the future. Please use the references for more help. In particular the JHBuild
documentation   will be helpful.
There are some ancient mails which might give a bit of context, but
there is also a lot of obsolete information in them: