Building Apache Kato
====================

Apache Kato needs Maven 2.0 or above and a Java 6.0 JDK.
To build the native libraries on Linux, GCC will have
to be installed. Please consult your distribution's installation
on how to do so.

For the native libraries to be built on Windows, Microsoft's
Visual C++ will have to be installed.

Maven can be downloaded from:
    http://maven.apache.org/download.html

Sun's JDK 6.0 can be downloaded from:
    http://java.sun.com/javase/downloads/index.jsp

Other JDK's should also be sufficient.

To build the jar files and documentation, go into the base directory and type:
    mvn install


The native libraries are not built as part of the main build. To do so, first
the JAVA_HOME variable must be set to your install JDK location. 
On Windows the "vcvars32.bat" script must be run before maven is launched.
To start the build, simply run "mvn install" in the "kato.native" directory.

The kato.docs project might fail with an OutOfMemoryError. To prevent this from
happening, the MAVEN_OPTS environment should be set to "-mx512m" to given Java a
sufficiently large heap.

Packaging
=========

Packaged binaries and source files are built by running:
    mvn assembly:assembly

in the kato.distro and kato.native.distro directories.