The HadronZoo Suite comprises the complete C++ source code of the HadronZoo C++ Class Library version 9.6 (beta), together with three programs based on upon it,
namely HadronZoo::Epistula, HadronZoo::Dissemino and HadronZoo::Autodoc. Our current development and test environment is 64 bit Centos running g++ 4.4.7, so we
know the software compiles and works in this environment. However, we cannot give a comprehensive list of C++ compilers and Linux distributions the software
compliles and runs under.

It is our intention to supply data files for IP-address to location mapping as part of the Suite or as a separate download. However we are not yet sure of the
legal position on this and so cannot release the data we have compiled. The loaders in the HadronZoo library are optimized for the streamlined format of our data
files and not for the files available from the range of vendors. Unless we can clear our owm data for distribution, we will have to add the loaders so that you
can use whichever data set has the most suitable licencing for your site.

All programs based on the HadronZoo C++ Class Library, namely the Epistula Email Suite, Dissemino (Low Latency Website Engine) and Autodoc (HTML document
assembly from source code) are released under version 3 of the
GNU General Public License.

All documentation concerning the HadronZoo C++ Class Library, Epistula, Dissemino and Autodoc, are released under version 1.3 of the
GNU Free Documentation License.

These three licenses appear on this site as verbatim copies of those available from
www.gnu.org. Please read all three
licenses before downloading any software as by doing so, you are agreeing to be bound by the terms of these licenses. Note that the Lesser GNU General
Public License makes reference to the GNU General Public License.

Installation

The tar file unpacks to create a directory of 'HadronZoo'. Where you choose to put that is up to you as the makefiles all use relative paths. This should be in
a common area if multiple developers are to use it but it can be in your user area if not. You will need to set an enviroment variable of $HADRONZOO so that the
programs know where to find standard data supplied as part of the Suite.

To compile the library you will need to invoke 'make' in the HadronZoo/code/hzlib.9.6/src directory. This will create the file libHadronZoo.9.6.a in either
/usr/local/lib if you are root or $HOME/lib otherwise. Please make sure these target directories exist or alter the makefiles to write output to a suitable
location. Once the library is compiled, you can make Epistula, Dissemino and Autodoc by going to their respective source directories and invoking 'make'.
This will place executables in /usr/local/bin if you are root and $HOME/bin otherwise. Again ensure these directories are appropriate for your needs.