The code in this directory is

Copyright (c) 1994,1995 Andreas Koenig <a.koenig@mind.de>

and may be used, copied and redistributed under the same terms as perl 
(see the files README, Copying and Artistic in the perl distribution).

This is a modified version of the adaptor written for mSQL.
libmsql.a library written by David Hughes <bambi@Bond.edu.au>.

libmysql.a is written by Michael Widenius as a API for mysql.
This and other files are patched by Michael Widenius to reflect the changes
between the original for mSQL and the new version for mysql.

To use the adaptor you definitely have to install the database and the
library first.

Installing The Adaptor
----------------------

Unpack in any directory on your harddisk and run

    perl Makefile.PL
    make
    make test

The latter will give you some instructions, if mysqld is not running or
if a database "test" is not available. Rest assured, that no existing
data in this database will be overwritten.

If the tests finish with `ok', give it a try to

    make install

If anything fails, check the documentation of the ExtUtils::MakeMaker
module. Especially if you're facing problems with dynamic loading, set
up the environment variable PERL_DL_DEBUG to some value greater 0 to
get some more information from the DynaLoader.

Documentation
-------------

Documentation is available in pod format within the file Mysql.pm. You
can turn this file into a manpage or a html page with the pod2*
programs that come with the perl distribution. perl5.001m and better
supplies a "perldoc" program, so you can say now "perldoc Mysql". Later
perls will probably have support for you to say "man Mysql".

The tutorial that may be helpful for you is in the file mysql_test. This
file IS the test program for this package and illustrates nearly all
basic operations that are available.

...have fun,
andreas koenig <a.koenig@mind.de>

Micahel Widenius <monty@analytikerna.se>


