Installation instructions for Spit
==================================

Note
----
Before you try to build Spit yourself, check if there aren't any pre-built
packages for your OS/Distribution/... This will save you a lot of trouble,
and will save me a lot of build-specific questions.
If there aren't any packages that suit you, please drop me a note, so i can 
see what i can do.

Required packages (on all systems)
----------------------------------
Be sure you have the development packages (headers and libraries) of the 
following packages installed:
- Qt >= 3.2 (http://www.trolltech.com)
- libxml2  (http://www.xmlsoft.org/)
- libxslt (http://xmlsoft.org/XSLT/)
- libexslt (http://xmlsoft.org/XSLT/EXSLT/)


GNU/Linux
---------
First, untar the package and enter the source dir
    tar xzf spit-<fill in the correct version>.tgz
    cd spit-<fill in the correct version>

Now, configure the build process:
    ./configure
Append '--help' if you want to see what extra parameters the configure script
takes.

Build the whole project by typing
    make

If the build was finished succesfully, install spit by typing
    make install

Spit should be working now, so you can head on to the README file.


Windows
-------
NOTE: Due to the fact that the Qt 3 library has only been released under 
evaluation license for Windows and MacOS, you can only use Spit for
30 days, after which the Qt library expires. Also, this program hasn't
been tested too much under MS Windows, so expect even more bugs & problems
than in the X11 version.

You can either compile Spit using Microsoft Visual C++ or Borland C++.
A Borland C++ compiler can be downloaded from http://www.borland.com
Depending on your compiler, you first download the corresponding Qt 3
evaluation version and apply for a license key. After receiving the key,
install Qt. Make sure that Qt is correctly installed (it should be if the
installation process builds the example files sucessfully).

Now, unpack the Spit source distribution, open a DOS box (run 'command'),
and enter the dir where you unpacked Spit, and execute
    qmake spit.pro
    
This should create all the makefiles. Depending on your compiler, type
    nmake       (for Microsoft Visual C++ 6.0)
or
    make        (for Borland C++)

If all went well, 'spit.exe' should be created. Just double click on spit.exe
and start indexing pictures !
                                              

MacOS
-----
Same as for Windows: unpack the source tarball, go into the source directory,
and type:
    qmake
    make
This should build 'spit.app'. 
If you want to package it into a DMG, you can take a look at the Makefile.mac 
script from the CVS repository.
