-*-Mode: text-*- -[Tue Jul 19 23:02:44 1994 by cxh]-

tclsql-1.1 INSTALL file

tclsql is a tcl7.3 extension for use with Ingres6.4.  I've briefly
tested it under SunOS4.1.3.  I don't use Ingres anymore, so I don't
do much work with this package.

tclsql-1.1 is merely a new version that will compile with tcl7.3 and
tk3.6.  tqlsql-1.1 contains no new functionality.

tclsql Installation
-------------------

To build tclsql, you will need access to the Ingres 'esqlc' command,
so adjust your path accordingly.  Also, you will need to set your
II_SYSTEM environment variable (Thanks to Dan Casson
<dcasson@luna.ecte.uswc.uswest.com> for pointing these out).

Edit the top part of the Makefile, and type:
	make
Then type:
	make install

Note that this version of tclsql was built and tested with tcl7.3,
tk3.6 patchlevel1 and Ingres 6.4.  Other versions of tcl and Ingres
may or may not work.

gcc-2.5.8 can be used to compile tclsql and sqlwish.  In tclsql-1.0,
sqlwish would not compile with gcc, with tclsql-1.1, this is no longer
the case.


Tests
-----
The tests directory contains tclsql tests.

Some of these tests depend on the existance of a database called 'tutorial'.
This source for this database came from ~ingres/ingres/files/tutorial.

The tutorial database can be created with:
	createdb tutorial
	(cd $II_SYSTEM/ingres/files/tutorial; cat copy.in | sql)

The contents of some of the tutorial database tables are in
tests/tutorial_db. 

To run the tests, in the top level directory, type:
	make tests

The tests also serve as example tclsql code.


Bugs
----

Send your bug reports and comments to cxh@eecs.berkeley.edu
