Development source code

This website holds the main branches of development using the version control system Git. Git is most famous for its use to develop the Linux kernel. If it is unfamiliar to you, then this page presents a quick guide to getting the xwax development source code. There is lots more documentation and tutorials and the Git website is the best place to start looking.

Getting the xwax source

To make a fresh checkout of all the branches of development held on the xwax site:

$ git clone http://www.xwax.co.uk/devel/xwax.git

This creates a new directory xwax containing the code. For a graphical view of the development you could use gitk, which comes as standard with Git:

$ cd xwax
$ gitk

To pull in the latest changes from the repository:

$ git pull

There's a lot more to Git than this, particularly when it comes to the fact that you can keep your own local development branches (as many as you like) without needing to have commit access to the main repository, and easily share these. Hopefully this will be ideal for your xwax experiments!

Compiling

The xwax build process is very simple. To build a binary for your platform, first select the options you wish to build xwax with, and then build; for example:

$ ./configure --enable-alsa
$ make

If this completes successfully, the result is an xwax binary.

Compilation errors are most likely the result of missing libraries. You need the libraries and header files installed for:

To keep track of dynamic dependencies, so that the build process knows which parts to recompile when .h files are changed, use:

$ make depend

Getting a branch

Ensure the latest changes are brought into your local repository: 
$ cd xwax
$ git fetch
To go to the latest work on the 'jack' branch, for example: 
$ git checkout origin/jack
To see all the current branches: 
$ gitk --all