Imported Upstream version 3.05
[sven/mysqltcl.git] / README
1 Tcl/Tk 8.0 interface to MySQL
2 ============================= 
3
4 This is a rewrite of a patched version of Hakan Soderlund's
5 msqltcl-1.50. I removed all support for older versions of Tcl. If you
6 are going to use older versions of Tcl, the patch (for msqltcl) found
7 at http://www.tcx.se will do the job for you.
8
9 The interface can be used as tcl package that is dynamically linked
10 shared library.
11
12 For copyright and licensing information, look in the README-msqltcl
13 file. The same condition holds, but don't forget to mention me ;)
14
15 Compilation
16 ===========
17 The system has been compiled on
18 - SunOS 5.5.1 sparc
19 - SunOS 5.6 sparc
20 - Linux 2.0.32 i586
21
22 The settings for these systems are all in the Makefile. Take a look at
23 the paths at the beginning, and adjust them for your system. The code
24 is written in "close-to-ansi-c", so it should be straight forward to
25 compile the static version. It could however be troublesome to compile
26 the dynamic library, because of the anti-standard of shared
27 libraries... :( Some experiments with the flags and paths might just
28 do the trick!
29
30 Set the SHARED variable to compile the shared library. The PLATFORM
31 variable should be set to something similar to 
32 `uname -prs | sed 's/ /-/g'` for your system. If there are no preset
33 configuration for your system, it is time to do some testing ;)
34
35 Please report any successful compilations under new configurations
36 to me, so that I can rewrite the makefile.
37
38 New features
39 ============
40 The package is already full of nice features. I added the possibility
41 to set user and password at connection time and support for all(?)
42 MySQL types in mysqlcol. However, I would recommend using the "SHOW
43 COLUMNS..." command for new code.  The port can (as always) be set
44 using an environment variable (see MySQL documentation.)
45
46
47 Use and abuse this software as much as you want as long as you follow
48 the license agreement in the README-msqltcl file.
49
50 Tobias Ritzau
51
52 VERSION 2.0
53
54 Version 2.0 supports all Tcl8.0 features, uni-code strings and is
55 faster than old versions.
56 Compilation and Installation is made by using 
57 ./configure scripts based on TEA
58 It was internal redesigned to support unlimited connection number and
59 is multi thread safe
60
61 New mysqltcl Homepage 
62
63 http://www.xdobry.de/mysqltcl
64
65 Contact:
66 Mail to both:
67 Tobias Ritzau configure script support
68 Artur Trzewik <mail@xdobry.de> code support