Important notices
=================

  1) mysqlwdb currently works ONLY with MySQL.
     
     Anyway, it's designed to work (in some future(?) version) with all the
     DBMS that are supported by the DBI standard (i.e. that have a DBI 
     compliant driver: a DBD.  Search on http://search.cpan.org for details). 
     
     If you are able to write new code to support others DMBS, change the 
     $DBI_driver variable according to your DBMS and set the $mysql_specific 
     variable to 0.

     mysqlwdb works properly with at least MySQL 3.21 releases.
     With MySQL 3.20.* mysqlwdb is not able to create or change records due
     to a different "LOCK TABLES" syntax of that old release of MySQL.
  
  
  2) mysqlwdb has been created and tested on a Linux Slackware 7.0 
     environment with:
  	
  	a) Perl 5.005_03
  	b) DBI 1.02
  	c) Msql-Mysql-modules-1.2007
  	d) MySQL Ver 9.16 Distrib 3.21.33c
  	
  	(with Apache 1.3.9 and Netscape Communicator 4.76)
  	
  	Anyway, it should work on every system having the packages above 
  	( from a) to d) ), same or higher version.
  	
     I have also successfully tested and developed mysqlwdb on

	a) Windows95 OSR2 with:

  		i)   Perl 5.005_03 binary build 522 from Activestate
  		ii)  DBI 1.14
  		iii) DBD-mysql ppm 2.04.1
  		iv)  MySQL Ver 11.6 Distrib 3.23.28-gamma (and also 3.23.37)

  		(with both Netscape Communicator 4.76 and Microsoft IExplorer 5.5,
	  	and Microweb as web server: http://www.indigostar.com/microweb.htm)

	b) Windows98SE with:

  		i)   Perl 5.6.1 binary build 629 from Activestate
  		ii)  DBI 1.14
  		iii) DBD-mysql ppm 2.0400
  		iv)  MySQL Ver 11.15 Distrib 3.23.43

  		(with both Netscape Communicator 4.78 and Microsoft IExplorer 5.5SP2,
	  	and Microweb as web server: http://www.indigostar.com/microweb.htm)

	c) Linux Slackware 8.0 with:

  		i)   Perl 5.6.1
  		ii)  DBI 1.20
  		iii) DBD-mysql 2.0902
  		iv)  MySQL Ver 11.15 Distrib 3.23.43

  		(with Netscape Communicator 4.77 and Apache 1.3.20)

	d) Windows XP Pro:

  		i)   Perl 5.6.1 binary build 633 from Activestate
  		ii)  DBI 1.23
  		iii) DBD-mysql ppm 2.0400
  		iv)  MySQL Ver 11.18 Distrib 3.23.51

  		(with Netscape Communicator 6.2, IE 6, Opera 6 and Apache 1.3.26, IIS 5.1)

  3) In order to use mysqlwdb properly (to update and to delete records,
     no problems with insert and select operations) with MySQL,
     **every table you manage MUST have AT LEAST one unique primary key field in place**


  4) mysqlwdb works properly with tables and fields *names*

  	a) WITHOUT spaces
  	b) WITHOUT @ characters
  	b) WITHOUT # characters

     I know that MySQL does NOT accept spaces or @/# in tables and fields
     names.

     If I am wrong and if you want to use @/# characters in tables and/or
     fields names please change the $delimiter and $pri_key_delimiter variables,
     with characters that does NOT appear in your tables/fields (NOT spaces).


  5) This software is distribuited WITHOUT any warranty.  Please be careful
     to let somebody use this software on your data.  You can disable several
     dangerous operations like drop, delete and update, setting to 0 the
     correspondent variables in the 'DBMS actions' section of the CGI script.