bonddb

http://bonddb.treshna.com
==========================================================================

Setting Up:

In order to make and install this libary you need postgresql development
files and glib installed on your system.  Make sure you have postgresql
version 7.3 or higher and glib1.2 or higher if installed if you run into
problems.

The dbtest programme requires a sample database set up on your system.
It will use this database to test itself and functionality.  Create a 
database, (ie bonddb) and then modify the src/bond.conf file to
correctly point to that database and have the correct username.

There is a createtestdb.sql file which you can input into your postgresql
database to fill in the sample data.  To install the database become
the postgres user, type createdb testbond then 
psql -f createtestdb.sql testbond.

Run the test programme by going ./dbtest 0-20 etc.

To compile bonddb you need scons installed. Scons is a Makefile
replacement. Type scons followed by scons install to build
the source code.  Make compability has been left in.

General Notes:

You need to run ./configure to create the makefiles if you want to still
use the gnu build system. If you have problems with this in regard to 
autoconf and have autotools installed try running ./rmbootstrap and 
./bootstrap to re-generate the ./configure file.  There
can be incompatiablities between archetures sometimes.

Please check the docs directory, website and reference directory for
more information on using bonddb.  db.h is the main api file which you
should include in your source code.  It can be quicker to look up the
functions in the db.c and db.h file as a quick reference on the api calls.

The libary currently has high debugging on and told to get the hell out of
there if it thinks anything is slightly wrong.  This will mean your get a
lot of assertion failures when you first start playing, dont worry about it.
In time when i belive this to be really stable a lot of the assertions will
be made warnings. At the moment if data is missing from the database, or a 
form references a field that doesn't exist, or a 101 other minor things 
happen when you first create your fields bond calls an g_assert(NULL); 


Dependences:

flex
bison
libtools
postgresql-dev
libglib2.0

