hello!

this directory contains a number of example packages which show
how dbconfig-common can be used in various situations:

- db-test-mysql

a simple mysql database application.

- db-test-mysql-perl

like the above, but instead of using dbconfig-common's native
setup code, the information is gathered and passed to a
maintainer-provided or upstream-provided script.

- db-test-mysql-frontend

a "read-only frontend" package. this package prompts for all the
pertinent information, but performs no database-modifying actions.

- db-test-pgsql

like db-test-mysql, but for applications that work with postgres.

- db-test-pgsql-migration

the same as above, but provided with a "1.9" version that doesn't
use dbconfig-common, which illustrates how in the "2.0" version
dbconfig-common can migrate previously existing settings.

- db-test-multidbtype

this package shows how dbconfig-common can be used to configure
applications that work with any number of database types supported
by dbconfig-common. currently this is only mysql/pgsql, but
work is in progress to support others, such as oracle and sqlite.

also, you probably see that one of the packages (db-test-mysql) has
two versions available. this simply shows how dbconfig-common can
support application upgrades that require making modifications to
the underlying database.

you can build all these packages at once by simply running the
provided ./buildpackages.sh script if you're lazy :)

enjoy!

-- sean finney <[email protected]> Sun, 02 Apr 2006 17:35:03 +0200