X-Git-Url: https://git.sven.stormbind.net/?p=sven%2Fmysqltcl.git;a=blobdiff_plain;f=README-msqltcl;fp=README-msqltcl;h=1c7889247f675653dfceba72323fe00f11fa92a2;hp=0000000000000000000000000000000000000000;hb=8b83892bf9d924349d5e09c88f16790a8086a950;hpb=b47a140e1d8fa10b34c244d077b2a3a7f36c7ff8 diff --git a/README-msqltcl b/README-msqltcl new file mode 100755 index 0000000..1c78892 --- /dev/null +++ b/README-msqltcl @@ -0,0 +1,118 @@ + +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 $