Tcl/Tk 8.0 interface to MySQL
=============================

This is a rewrite of a patched version of Hakan Soderlund's
msqltcl-1.50. I removed all support for older versions of Tcl. If you
are going to use older versions of Tcl, the patch (for msqltcl) found
at http://www.tcx.se will do the job for you.

The interface can be used as tcl package that is dynamically linked
shared library.

For copyright and licensing information, look in the README-msqltcl
file. The same condition holds, but don't forget to mention me ;)

Compilation
===========
The system has been compiled on
- SunOS 5.5.1 sparc
- SunOS 5.6 sparc
- Linux 2.0.32 i586

The settings for these systems are all in the Makefile. Take a look at
the paths at the beginning, and adjust them for your system. The code
is written in "close-to-ansi-c", so it should be straight forward to
compile the static version. It could however be troublesome to compile
the dynamic library, because of the anti-standard of shared
libraries... :( Some experiments with the flags and paths might just
do the trick!

Set the SHARED variable to compile the shared library. The PLATFORM
variable should be set to something similar to
`uname -prs | sed 's/ /-/g'` for your system. If there are no preset
configuration for your system, it is time to do some testing ;)

Please report any successful compilations under new configurations
to me, so that I can rewrite the makefile.

New features
============
The package is already full of nice features. I added the possibility
to set user and password at connection time and support for all(?)
MySQL types in mysqlcol. However, I would recommend using the "SHOW
COLUMNS..." command for new code.  The port can (as always) be set
using an environment variable (see MySQL documentation.)


Use and abuse this software as much as you want as long as you follow
the license agreement in the README-msqltcl file.

Tobias Ritzau

VERSION 2.0

Version 2.0 supports all Tcl8.0 features, uni-code strings and is
faster than old versions.
Compilation and Installation is made by using
./configure scripts based on TEA
It was internal redesigned to support unlimited connection number and
is multi thread safe

New mysqltcl Homepage

http://www.xdobry.de/mysqltcl

Contact:
Mail to both:
Tobias Ritzau configure script support
Artur Trzewik <mail@xdobry.de> code support

Msqltcl --   Tcl interface to the Mini SQL (mSQL) database server
             by David J. Hughes

Author:      Hakan Soderstrom, hs@soderstrom.se
Affiliation: Soderstrom Programvaruverkstad AB, Bandhagsvagen 51,
             S-122 42 Enskede, Sweden

-------------------------------------------
Copyright (c) 1994, 1995 Hakan Soderstrom and Tom Poindexter
Additional details at end of this file.
-------------------------------------------


VERSIONS, PORTS

This is release 1.50 of msqltcl. It has been tested with Tcl 7.3,
Tk 3.6p1, TclX 7.3a-p2; Tcl 7.4b2, Tk 4.0b2, TclX 7.4a-b2, mSQL 1.0.6
under SunOS 4.1.3. Successful ports to several other platforms have
been reported. I would expect msqltcl to run wherever Tcl/Tk and mSQL
succeed.


WHAT IS MSQLTCL?

Msqltcl is an extension to the Tool Command Language (Tcl) that
provides high-level access to a Mini SQL (mSQL) database server. Mini
SQL (mSQL) is a freely available, lightweight database engine.

Msqltcl features:
   -- supports multiple connections to one or more database servers,
   -- supports all Mini-SQL statements,
   -- returns SELECT query results either as Tcl lists, or iterates
      a script over the resulting rows,
   -- accesses information about databases, tables, columns.

The package also contains a useful Mini-Monitor (mmon) written in
Tcl/Tk. It requires TclX and is currently limited to pre-4.0 Tk.


ACKNOWLEDGEMENTS

Obviously msqltcl is just a small addition to a much greater work done
by John Ousterhout (Tcl/Tk) and David J. Hughes (mSQL).

Msqltcl is derived from work by Tom Poindexter (tpoindex@nyx.cs.du.edu)
whose Sybtcl and Oratcl are useful patterns for Tcl database extensions.


DOCUMENTATION

Yes, a decent man page.


REQUIREMENTS

You must have Tcl/Tk and Mini SQL.

** Tcl/Tk by John Ousterhout is available from numerous FTP sites. For
one-stop retrieval, look in ftp.aud.alcatel.com:/tcl. You will find
the Tcl/Tk distribution in /tcl/ftp.cs.berkeley.edu, extensions (one
of which is msqltcl) in /tcl/extensions. You may want to get the file
/tcl/MIRRORS to discover a mirror site near you.

The Tcl/Tk Book is "Tcl and the Tk Toolkit" by John K. Ousterhout,
Addison-Wesley 1994, ISBN 0-201-63337-X.

** Mini SQL (mSQL) is a freely available, lightweight database engine
developed by David J. Hughes, Bond University, Australia. The source
code can be obtained by FTP from Bond.edu.au:/pub/Minerva/msql.

There is an mSQL mailing list. Join it by sending a message to
msql-list-request@Bond.edu.au.


INSTALLATION

See the file INSTALL.


BUG REPORTS

Although I have made a conscientious effort to provide zero-defect
software and documentation, this release of msqltcl may still contain
blunders of varying magnitudes.

Comments, suggestions, bug reports (maybe even encouragement!) should be
mailed to me at the E-mail address above. Please include some
information about your environment (platform, OS version, Tcl/Tk
version, mSQL version, msqltcl version). Please include enough
information for me to be able to reproduce any suspect behaviour. If you
have a solution to a problem, please include a patch.

I can't guarantee that I will fix your bug, but I'll do my best.


COPYRIGHT & LICENSE

Copyright (c) 1994, 1995 Hakan Soderstrom, Enskede, Sweden
and Tom Poindexter, Denver, Colorado

Permission to use, copy, modify, distribute, and sell this software
and its documentation for any purpose is hereby granted without fee,
provided that the above copyright notice and this permission notice
appear in all copies of the software and related documentation.

THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND,
EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY
WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.

IN NO EVENT SHALL HAKAN SODERSTROM OR SODERSTROM PROGRAMVARUVERKSTAD
AB BE LIABLE FOR ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL
DAMAGES OF ANY KIND, OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS
OF USE, DATA OR PROFITS, WHETHER OR NOT ADVISED OF THE POSSIBILITY
OF DAMAGE, AND ON ANY THEORY OF LIABILITY, ARISING OUT OF OR IN
CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

$Revision: 1.1.1.1 $