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 stable release, plus
any patches that will be included in the next stable release. It should
be safe to run this version.
Other stable branches are rel/2.x
and
rel/3.0.x
, representing the 2.x and 3.0.x release series
respectively. These branches also 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.
The next
branch contains the latest development version,
which may be unstable and/or severely broken. Follow it at your own
risk.
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@aox.org).
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@aox.org.