GIFT Prerequisites Package:

This package contains about all the packages you might
need for running the GNU Image Finding Tool.


A large part of these sources, as well as this readme
are quite directly derived from the "Benchathlon Starter
Package (*NIX version)" which we cite in full below.

---------------------------------------------------------------

Benchathlon Starter Package (*NIX version)

This Benchathlon Starter Package groups software which is useful
when making a content based image retrieval system ready for use
within the Benchathlon (You don't know what the Benchathlon is? Try
http://www.benchathlon.net).

Please note, that only a small fraction of the software in this
package has been written for the Benchathlon. Most of the packages
bundled contain are generic modules for using XML and are bundled for
your convenience. Find descriptions about the authors and license of
each piece of the software in the corresponding sub-directories and
files. Please notice and apply the license of each software
package. WE EXPLICITLY DO NOT GUARANTEE THAT THE LICENSE OF ALL
PACKAGES USED HERE FIT YOUR NEEDS.

THE SOFTWARE IN THIS PACKAGE ESPECIALLY WRITTEN FOR THE BENCHATHLON IS
DISTRIBUTED UNDER THE SAME TERMS AS PERL ITSELF.

---------------------------------------------------------------
INSTALLATION
------------

EITHER you know how to install Perl packages and Free Software
packages that use autoconf. Then do things by hand, and install them
where you like.

OR, use  install-as-root.sh or install-in-home.sh

For the *former*, you will need to be root. There is nothing special
to be said about that case. Start install-as-root.sh, and see what 
happens. Errors are quite improbable. Complain to the mailing list if 
you encounter one.

The latter case is more special, and you need it only if you cannot 
be root on the machine you are using:
install-in-home.sh will install all libraries and Perl modules of
this package into the ${HOME}/perl directory tree. Simply run

sh install-in-home.sh

Afterwards, for using what you've installed, you will need to run
either 

source env.sh

(if you are using sh or bash as a shell)

or 

source env.csh

(if you are using tcsh)

After that, please consult the man pages to get more information. 
The following manpages are available:

(most important)

CLIAdapter
TestingClient

(Less important)

MRML::Server::Base
MRML::Server::Base::Visitor
MRML::Server::CLIAdapter::Visitor
MRML::Client::Base
XML::Parser::Expat

And (more generic, less important).

XML::Parser
BenchathlonStarterPackage
XML::Parser::PerlSAX
Data::Grove::Parent
XML::Perl2SAX
XML::Handler::CanonXMLWriter
XML::Handler::Subs
XML::SAX2Perl
XML::PatAct::Amsterdam
XML::PatAct::MatchName
Data::Grove::Visitor
XML::ESISParser
Data::Grove
XML::PatAct::PatternTempl
XML::PatAct::ToObjects
XML::Handler::Sample
XML::Handler::XMLWriter
XML::PatAct::ActionTempl
XML::SAX::Base
XML::SAX::Exception
XML::SAX::PurePerl
XML::SAX::ParserFactory
XML::SAX
XML::SAX::PurePerl::Reader
XML::Writer
XML::Handler::EasyTree::Visitor
XML::Handler::EasyTree::Traversal
XML::Handler::Trees
