File	Date	Author	Commit
debian	2012-11-29	Philip Ashmore	[a177d0] Version 1.5.0-02
v3c	2016-12-31	Philip Ashmore	[084a9e] Version 1.5.0-04
AUTHORS	2010-05-10	Philip Ashmore	[8b07e5] Snapshot before re-shuffle
COPYING	2010-05-10	Philip Ashmore	[8b07e5] Snapshot before re-shuffle
COPYING.LESSER	2010-05-10	Philip Ashmore	[8b07e5] Snapshot before re-shuffle
ChangeLog	2016-12-31	Philip Ashmore	[084a9e] Version 1.5.0-04
INSTALL	2010-11-30	Philip Ashmore	[4d4687] Release 1.0.0-01
LICENSE.txt	2010-05-10	Philip Ashmore	[8b07e5] Snapshot before re-shuffle
Makefile.am	2012-07-08	Philip Ashmore	[8ac04f] Version 1.4.1-03
NEWS	2016-12-31	Philip Ashmore	[084a9e] Version 1.5.0-04
README	2016-12-31	Philip Ashmore	[084a9e] Version 1.5.0-04
TODO	2010-11-16	Philip Ashmore	[6c1b46] Release 0.9.0-01
configure.ac.in	2012-11-29	Philip Ashmore	[a177d0] Version 1.5.0-02
doxygen.cfg	2012-07-03	Philip Ashmore	[a9874f] Version 1.4.1-02
makefile	2016-12-31	Philip Ashmore	[084a9e] Version 1.5.0-04
meta-treedb.m4.in	2012-03-04	Philip Ashmore	[a717bc] Version 1.4.0-01
meta-treedb.pc.in	2011-12-19	Philip Ashmore	[0dd07a] Version 1.4.0-01
setup_kdbg	2011-06-15	Philip Ashmore	[23f957] Release 1.3.0-01

Read Me

Introduction
============
meta-treedb is designed to eliminate the multiple includes that typify programs
based on treedb by providing common interfaces regardless of the tree
implementation, preventing code bloat and allowing other imlementations to be
used when available.

1-comet
-------
This pathfinder contains v3c-meta-comet, the meta-treedb version of treedb's
v3c-comet. It seems a bit faster as it uses a slightly smarter approach.

Also included are the meta-treedb versions of the C++ treedb tests.
I didn't write "C" versions as the C++ ones took less time.

Directory layout
================
treedb (you are here)
 |- build (everything created goes here, as far as the tools will allow)
 |   \- v3c
 |       |- 1-comet
 |       \- docs
 \- v3c (the source)
     |- 1-comet
     \- docs

The reason for the "v3c" subdirctory is so test programs can
  #include <v3c/something>
just like client programs.
This works as
  -isystem \$(srcdir)
is added to CPPFLAGS by configure.ac.in.

Requirements
============
This is a sub-project of treedb so you'll need that and all that it requires.

Debian/Ubuntu packages
======================
If you run
    make debian
the build system will compile and distcheck meta-treedb before creating a
.tar.gz tar ball.
This tar ball is then used by the build system to build the debian packages.
You will need a gpg public/private key pair if you want to sign these packages -
more info can be found in the "maint-guide" debian package.

doxygen
=======
Meta-treedb uses v3c's doxygen "documentation chain" so that other projects can
layer their doxygen documentation on top easily.

Then to install the documentation
    make <flags> doxygen-doc && sudo make install-doxygen-doc

Using meta-treedb
=================
The default install location determined by configure is "/usr".

You can specify your own (eg. ~/test) by
    make prefix=~/test check

Feedback
========
All feedback should be through this projects support web page
    http://sourceforge.net/projects/meta-treedb/support.
I've added a help, open discussion and a mantis bug tracker there.

Finally, do send me an email to let me know what your thoughts are on
meta-treedb!