Wed Oct 28 15:30:32 1992

You should have all the pieces mentioned below:

	Bill Of Materials for Tcl Postgres extensions.

	PQTclmain.cc	- Mainline for C++ Tcl shell.
	PQTcl.hpp 	- Header file for Postgres extensions in C++.
	PQTcl.cc  	- Postgres extensions in C++.
	tcl++.hpp 	- Updated tcl++.h class.
	tclmain.c	- Mainline for C Tcl shell.
	libpqcmds.c	- Postgres extensions in C.
	libpqcmds.h	- Header file for extensions in C.
	patchlevel.h	- Blasted patchlevel header file.
	Makefile  	- File to compile above.
	getrecords.tcl	- sample tcl code.
	READ.ME   	- This file.

Unless you have the Postgres extended relational database from the University of California, Berkeley,, this material is useless to you...you may stop now.

At OSSI we are developing new commercial products using Tcl and Tk.  We believe
the extensibility of Tcl makes it an ideal language for our needs. We also
hope that Tcl continues to grow and gain acceptance throughout the world.  We
are offering these extensions back to the Tcl and Postgres communities as a 
small token of our appreciation for the tremendous effort that has gone into 
these products.

These files provide C and C++ versions of the LIBPQ C Postgres interface for
the Tcl language.  The extensions allow Postgres tables to be manipulated from
within Tcl scripts.  Adding relational database capability to Tcl in 
conjunction with Tk makes a potent combination for a simple and easy to use
language.

The extensions for C are written following the style found in the tcl and tclX
source.  In particular, the command extensions are written as a package that
can be added to an interpreter.

The mainline for each environment should make it obvious how to use each
set of extensions and a small piece of sample Tcl code has been provided
which can create a table, populate it, and retrieve it as a list.  Beyond
this and you are on your own.

CAVEAT - The C++ version has been used fairly extensively, while the C version
has not.  Testing shows everything working, but you may wish to do your own
before doing much of anything serious.

This code has been developed using SunOs 4.1.x, Sun C++ version 2.1, Sun C, 
and Postgres version 4.0.1.  Your mileage may vary.


You may find it interesting to compare the C and C++ versions of the extension
sets.  It is our feeling that C++ is the superior approach; we are using
the PQTcl class in conjunction with several other "Tcl extension" classes in
our developement work at this time.  The class structure provides a convenient
way to package Tcl extensions 

Regards,
---------------------------------------------------------
Robin J. Maxwell              | Email:  rmaxwell@ossi.com
Open Systems Solutions, Inc   | Voice:  (408) 456-7281
3055 Orchard Drive            | FAX:    (408) 456-7050
San Jose, CA 95134-2022       | Coins:  7921-7050