** Requirements

In order to build Kenya, you will need a few tools:

- Java SDK (http://java.sun.com/j2se), at least version 1.5. In order to run the tests you will
  need to have Java 1.6 installed
- for running the installer you will need to have IzPack package deployment installed (http://izpack.org/)

Additionally, for building the Kenya system, you will need: perl and xsltproc. We use
Mercurial (http://mercurial.selenic.com) as our Distributed Version Control System, so if you also want to
run associated tests, then you will need to have it installed. These are usually packaged
in the standard OS version.


** Building the Kenya system

Change to the Kenya directory, and copy file 'sample.config.properties' to 'config.properties'.
This file contains basic information necessary to locate required software and customise the build of the
Kenya system. The properties should be self-explanatory.
Properties with prefix 'test' define the location and revision of test repository that we want to use.
The default values can be left if you are not planning to run the test framework. Please, note that access
to this repository is currently restricted.

Type, 'ant' and you should have the compiled java classes in the 'build/classes' directory.
Other interesting Ant targets include:

- dist - builds the Kenya system and packages the classes into jars, see directory 'build/dist'
- dist-src - create a distributable source zip file with all the necessary files nicely packaged 
- test - run the test framework. Note that this currently requires priviliged access to the test repo
- clean - removes all the products of the build process and set the directory structure to the pristine state
- installer - create all the installers of the kenya system. The result is in 'build/dist/installers' directory

** Running

In order to run the Kenya system 'by hand', i.e. not using the installer, you will need to have also all the
graphical libraries on the classpath (apart from the just built Kenya jar files). For your convenience we
provide all the necessary graphical libraries in the 'lib' directory. Choose those suitable for your system.

If running from eclipse it might be necessary to specify the location of native graphical libraries. This can
be easily set by going to the project Properties -> Source -> Native library location. For instance for linux
32-bit architecture that would be 'lib/linux' directory.