readme

DataDraw is an ultra-fast persistent database for high performance programs written in C. It s so fa

DataDraw3.0 is the latest in a long line of DataDraw database generators.  It takes a database
description file and creates C code that links the database directly into your C program.

I wrote version 3.0 in 2006, starting with code from version 2.0.  Version 3.0 inherits it's
copy-left from version 2.0.  It is copyrighted under the GNU Library General Public
License.  You should have received a copy, and if not, you can find it on fsf.org.

Version 3.0 is modern, feature-rich, and well documented.  I hope you find it useful for your
project.  The manual is in manual.odt, which is "Open Document Format", compatible with multiple
many word processors, just none currently from Microsoft.  I wrote it using OpenOffice, which I
highly recommend.  Installation and usage instructions are in the manual.
fully documents DataDraw 3.0.

If you just want to compile it now, before reading the manual, just type this:

    $ cd datadraw3.X.X/src
    $ ./configure
    $ make
    $ su
    $ make install
    $ exit

The only option to the "configure" script is "--prefix=<dir>", to let you install in a different
directory than /usr/local/bin.  You also need to install DataDraw's utility library:

    $ cd util
    $ ./configure
    $ make
    $ su
    $ make install
    $ exit

This should install a "datadraw" executable, which you can use on database description files
(ending in ".dd").  The following will generate the C database:

    $ cd src
    $ datadraw dvdatabase.dd

The output files are dvdatabase.c and dvdatabase.h, which you can check out.  I recommend taking
some Advil before reading the generating code.  The manual where I recommend you start.

For a good example of a DataDraw3.0 application, just check out the files in src (other than the
generated dvdatabase.c and dvdatabase.h files).  DataDraw creates it's own database!

The convertTo3.0 script is exactly what I used to convert the original DataDraw3.0 code into a
format compatible with DataDraw3.0 databases.  The original was written using DataDraw2.0.  This
script may be helpful in upgrading other DataDraw2.0 applications.