Msqltcl --   Tcl/Tk interface to the Mini SQL (mSQL) database server

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

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


VERSIONS, PORTS

This is release 2.30 of msqltcl. It has been tested with Tcl 7.6,
Tk 4.2, mSQL 2.0.1 under SunOS 4.1.4 and Solaris 2.5.1. Successful ports
of earlier versions to other Unix platforms have been reported. I would
expect msqltcl to run wherever Tcl/Tk and mSQL succeed.

This version of msqltcl is not compatible with Tcl/Tk version 8, or with
mSQL 1.


WHAT IS MSQLTCL?

Msqltcl is a Tcl/Tk extension providing high-level access to a Mini SQL
(mSQL) database server. Mini SQL (mSQL) is a freely available (but not
necessarily free), 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, etc.

Msqltcl may be configured as a dynamically loadable package on platforms
supporting this feature.

The msqltcl distribution contains a window-based Mini-Monitor (mmon)
written in Tcl/Tk and msqltcl.


UNPACKING AND INSTALLING

The msqltcl distribution comes in a file called msqltcl-X.Y.tar.gz,
where X.Y is the release number. cd to a directory under which you want
the msqltcl directory to be created. Then,

   gunzip < msqltcl-X.Y.tar.gz | tar xvf -

This will create a new directory called msqltcl-X.Y in the current
directory and unpack the msqltcl source files in the new directory.

`cd' into the new directory. You will find additional installation
instructions in a file named INSTALL.


ACKNOWLEDGEMENTS

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


DOCUMENTATION

A reference manual (HTML) for msqltcl. Mmon includes on-line
documentation.


REQUIREMENTS

You must have Tcl/Tk and Mini SQL.


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 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-1997 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: 2.30 $