Getting the source code

The source code for Theodolite is versioned using the darcs revision control system. darcs is a simple yet powerful decentralized source control system that requires no special server. Precompiled binaries for various OSs can be downloaded from http://abridgegame.org/darcs/.

The URL for the source code is http://theodolite.sourceforge.net/darcs/theodolite

To get started with the Theodolite you can use the darcs get command:

darcs get http://theodolite.sourceforge.net/darcs/theodolite

Should you want to make a contribution, you can record a patch and send it by email:

darcs add [WHATEVER NEW FILES]
darcs record
darcs send

Some useful darcs commands

You can summarize all local changes by asking whats new:

 darcs whatsnew -s

If you want to a synopsis of what new files you've created without actually invoking the add command you can use the --dry-run option combined with a quiet flag:

 darcs add -r --dry-run -q *

This shows what darcs would add if you would have invoked the add command recursively on a whole directory.

Please refer to the manual from darcs for more information.

Also, because it is just a simple directory structure, you also could get the source tree using wget recursively, if you don't want to install darcs.

Building from source

Theodolite uses the m2 http://maven.apache.org build lifecycle.

Once you have installed maven, you can build the sources by running:

 mvn install

To run the unit tests, run

 mvn test