Archiveopteryx with Git

The Archiveopteryx source code is maintained in a Git repository. You can get a complete copy of the Archiveopteryx repository by running:

git clone git://git.aox.org/aox.git

This will create a directory called aox containing the source code, almost as if you had downloaded Archiveopteryx. There are some minor differences: aox show build may report a misleading version number, and there is no Makefile. You will have to use Jam to build the code.

Branches

When you clone the repository the «master» branch is checked out by default. This contains the latest development version, which may be unstable and/or severely broken.

More stable branches are «rel/2.x» and «rel/3.0.x», representing the 2.x and 3.0.x release series respectively. These branches contain the latest release plus any changes queued up for the next release. It should be quite safe to run the latest version from either branch.

You can check out the «rel/3.0.x» branch with

git checkout -b rel/3.0.x origin/rel/3.0.x

This creates a local branch named «rel/3.0.x» that tracks the remote branch of the same name from the origin (i.e. git.aox.org/aox.git). You can keep running «git pull» to fetch new changes.

There's also a tag for each release, e.g. «v3.0.4» for Archiveopteryx 3.0.4. To see a list of tags, use

git tag -l

You can also check out any given release into a new branch by doing

git checkout -b rel/3.0.4 v3.0.4

Making and contributing changes

If you want to change the Archiveopteryx source, you should definitely read the git tutorial. Once you've made the changes, you can use git-format-patch and git-send-email to send the diffs to us (at info@oryx.com).

Git requirements

You need git version 1.5.4 or later to use this repository effectively.

$ git --version git version 1.5.4.5

At the time of writing, Debian includes packages only for the older 1.4.x. Use the packages from backports instead.

Relevant links

If you have any questions, please write to info@oryx.com.