This is a Perl adaptor for the MySQL database. You'll need it
if you have perl programs designed for the msql/PerlMsql team
and want to adapt them to the mysql server (replacing the msql
server).

This is ABSOLUTELY "BETA" and not tested thoroughly. However,
the "msql.t" and "pmsql" utilities that were included with
MsqlPerl-1.16 are working fine with this replacement (and
are included here, too).

The code in this package is
Copyright (c) 1994-1997 Andreas Knig <a.koenig@mind.de>

Changes have been made by Michael Widenius <monty@analytikerna.se>
and Frederik Ramm <ramm@rz.uni-karlsruhe.de> to the effect that 
nobody knows why certain things aren't working. Please see the
"Changes" file for latest news. 

How to install:
* perl Makefile.PL
* make
* make install

I (Fred) have deleted the rest of this README, see the original 
MsqlPerl docs for more. 


Incompatibilities between mSQL-2 and mysql:
- mSQL-2 returns the number of affected rows from msql_query,
  where mysql returns an object from which one can ask for 'affected rows' or
  'insert_id' or 'info'.
- Mysql doesn't have any static variables (which means one can have many
  connections up). From this follows that the following functions must
  be called with a mysql object:
  errmsg(), gethostinfo() ,getprotoinfo() ,getserverinfo(), getserverstats().
  The only info function that can be called directly is mysql_get_client_info.

  The global variable Mysql::db_errstr holds the last error message, but one
  should use mysql_object->errmsg instead.
  On can get the last error number with mysql_object->errno.

Monty
