README for MQdb.pm

MQdb.pm is a base toolkit for working with relational databases in the context
of a federation of object databases. It provides some base federation support
and a variation on an Object-relational-mapped template model.
Currently it supports mysql, oracle, and sqlite.
In theory it can also be used as a base object class for federation
without using relational databases.

Refer to the pod for full documentation and an example script, 
or to the following mirrors:

1/ http://search.cpan.org/perldoc?MQdb
2/ http://search.cpan.org/~jms

copyright (c) 2006-2009 Jessica Severin

CONTACT POINT
-------------

jessica.severin@gmail.com <Jessica Severin>
http://search.cpan.org/~jms

LICENSE
-------

* Software License Agreement (BSD License)
* MappedQueryDB [MQdb] system
* copyright (c) 2006-2009 Jessica Severin
* All rights reserved.
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are met:
*     * Redistributions of source code must retain the above copyright
*       notice, this list of conditions and the following disclaimer.
*     * Redistributions in binary form must reproduce the above copyright
*       notice, this list of conditions and the following disclaimer in the
*       documentation and/or other materials provided with the distribution.
*     * Neither the name of Jessica Severin nor the
*       names of its contributors may be used to endorse or promote products
*       derived from this software without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS ''AS IS'' AND ANY
* EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
* WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
* DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDERS BE LIABLE FOR ANY
* DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
* (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
* SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.


OVERVIEW
--------
MQdb.pm is a base toolkit for working with relational databases in the context
of a federation of object databases. It provides some base federation support
and a variation on other Object-relational-mapped template systems.

VERSION
-------
0.954 Wednesday  June 3, 2009
0.953 Friday     April 17, 2009
0.951 Thursday   April 2, 2009

DOCUMENTATION
-------------
The following documentation is available:
pod in perldoc format (type perldoc MQdb::... on command line)

INSTALLATION INSTRUCTIONS
-------------------------
***THERE ARE TWO WAYS TO IMPLEMENT MQdb MODULE IN PERL***

	1/ Systems with CPAN support (all Unix/Linux/BSD/Mac):
	-----------------------------------------------------
	Install the new distribution via the Perl CPAN module:
	In a shell:
	/home/somewhere% perl -MCPAN -e"install MQdb"

	2/ The hard way (requires make or nmake, tar, gunzip, and gcc):
	---------------------------------------------------------------
	This method was tested in Irix, FreeBSD, Cygwin, debian linux, and Mac OSX
	Hard-headed users can directly get the distribution from 
	First download the source.
	Then, in a shell:
	/home/somewhere% tar -xzvf MQdb-0.954.tar.gz
	cd MQdb-0.954
	make
	make install


KNOWN BUGS & ISSUES
-------------------
none at this time.

COMMENTS/FEEDBACK
-----------------
Please email your feedback, comments, questions to the email address at the top
of this document. I will do my best to answer promptly. 

Jessica Severin <jessica.severin@gmail.com>