Cave Converter
--------------
Copyright (C) 2009-2013 Paul Fretwell - aka 'Footleg' (drfootleg@gmail.com)

Cave Converter is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

Cave Converter is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with Cave Converter.  If not, see <http://www.gnu.org/licenses/>.

-------------------------------------------------------------------------------
Building from Source
--------------------
Cave Converter can be built from the Java source code using the provided ant 
build script. But first you will need to download a couple of dependencies 
required to run the unit tests and generate code coverage reports for the 
tests. These dependencies need to be placed in folders with the following names
two levels higher in your directory hierarchy than folder containing the
build.xml ant script:

cobertura-1.9.4.1
junit

Cobertura can be downloaded from http://cobertura.sourceforge.net/
Junit can be downloaded via http://junit.sourceforge.net/

The cobertura zip file downloaded can be unzipped to create the directory
structure required. The junit-4.10.jar file needs to be placed it in a 'junit' 
directory (or edit the paths in the build.xml to point to the jar files if you 
want to use a different location or version).

Once the dependencies are in place (including a Java JDK 6 or later and Apache 
Ant 1.8 or later), you can run the following ant commands from a command prompt
in the CaveConverter_src folder where you unzipped the source.
NOTE: To enable the ant script to work on Linux (Debian) with Open-JDK it was
necessary to define the env.JAVA_HOME property in the build.properties file.
This was not necessary when building on a Windows machine where the system 
environment variable JAVA_HOME was already pointing to a JDK.
To build on Debian I added this line to build.properties:
env.JAVA_HOME=/usr/lib/jvm/java-7-openjdk-amd64/

To just build the release distribution:
 ant zip

This should generate the jar file in a build folder, and a complete 
distributable zip file in a dist folder.

To run full unit and regression tests, and generate code coverage reports:
 ant coverage.regressions
 
To generate the Javadoc:
 ant javadoc
 
To do a full clean build and generate everything (this is the default target):
 ant all
 
Other primary ant targets can be listed by running:
 ant -p
 
Note that some internal targets will not work with the source distribution 
as they are related to code in development which is not yet functional :-)

This source package has been put together with the full code needed to build 
the command line cave converter tool using OpenJDK6
