flaim-projects README file
==========================

NOTE: This README file covers platform-independant, and GNU/Linux and
Unix specific information. For information on building and installing
on Windows platforms, please see the README.W32 file.

Contents
--------
1. Project Hierarchy
2. Autotools Build
3. Windows Build

Project Hierarchy
-----------------

The flaim-projects repository is divided into four sub-projects, named 
for the sub-directories in which they reside:

  * flaim
  * ftk
  * sql
  * xflaim

Each of these sub-projects is a complete project in its own rite. The only
inter-project dependencies among them are that the flaim, sql and xflaim 
projects depend on the FLAIM Tool Kit library (libflaimtk) and header file
(flaimtk.h) provided by the ftk project.

When these four projects are built from the flaim/trunk directory, the 
dependencies are managed for you. 

However, each of the four sub-projects may also be built as separate 
projects, simply by changing into the desired directory, and running
configure/make from that location.

When you build flaim (for instance) by itself in this manner, you need to 
provide the location of the flaimtk library and header file in one of
two ways:

  1. provide the FTKLIB and FTKINC environment variables to configure
  2. create a sym-link within the flaim directory to ../ftk

Both of these techniques work with all three of the higher level projects.

Autotools Build
---------------

IMPORTANT: You must have installed Autoconf version 2.62, Automake version 
1.10 and Libtool version 2.2. These are the latest versions of these three
tools, as of this writing (July 2, 2008).

To build the flaim-projects from a Subversion working copy, just create
a clean working copy from the Subversion repository at:

  https://forgesvn1.novell.com/svn/flaim/trunk flaim-projects

Then enter the following commands from the flaim-projects directory:

  $ autoreconf -i
  $ ./configure && make all check 
 
You may also build from another directory by using a relative path to the
configure script, in this manner:

  $ mkdir build && cd build
  $ ../configure && make all check

To find out what options are available for these packages, you really need to 
check the configure script help page for each of the sub-projects. Most of the
options for each project are the same between all projects, but the ftk project
contains several more options, and the others also have options to help the
build system find the tool kit.

Check the help page for any of the configure scripts like this:

  $ ./configure --help=short

Once you know the options you wish to use, you may use them all on the 
flaim-projects configure script command line. Those not understood by any
given script will simply be ignored.

Enjoy!