---------------------------------------------------------------------
NAME
Postgres_pqatcl - Postgres access for Tcl/Tk
---------------------------------------------------------------------
DESCRIPTION
Postgres_pqatcl is a Tcl/Tk extension to access Postgres95
databases with embedded SQL and Postgres 4.2 databases with
embedded Postquel.
The extension is split into four parts:
* libpqatcl.so - a shared library to load the low level
communication interface into a Tcl interpreter. The
commands provide the handling of the frontend-/backend-
protocol on an asynchronous TCP/IP channel.
* sqlpqa.tcl - Tcl procedures that wrap around the low
level interface commands of libpqatcl.so and provide
embedded SQL for Postgres95 databases.
* epqpqa.tcl - Tcl procedures that wrap around the low
level interface commands of libpqatcl.so and provide
embedded Postquel for Postgres V4.2 databases.
* libbetcl.tar - Postgres95 extension for Tcl script
support in the database backend. Please read
README.libbetcl for more information.
REQUIREMENTS
* Postgres DBMS either Postgres95 or V 4.2.
* Tcl7.5p1/Tk4.1p1
INSTALLATION
Unpack the archive and change into the toplevel directory.
zcat Postgres_pqatcl-1.0.tar.gz | tar xvf -
cd Postgres_pqatcl-1.0
Edit the toplevel Imakefile and change the installation
path's and the manpage suffix to match your installation.
Create the Makefiles and build the library. Pardon me that
this is still under control of imake(1). Up to now I'm not
that familiar with autoconf(1) to push the shared lib build
into it.
xmkmf
make Makefiles
make
Install the extension. The following will install
libpqatcl.so, sqlpqa.tcl and epqpqa.tcl in the PQATCL_LIBDIR
from the Imakefile. The manpages get installed in
PQATCL_MANPATH.
make install
make install.man
It's up to you to create a new package index in the Tcl
library directory. Since every site might have another
structure for extensions and the package structure itself is
subject of discussion and change right now, I don't provide
any automatism for this.
Access your database.
BUGS / COMMENTS
Any bug reports, fixes, enhancements, comments and ideas are
welcome. Please send them to
wieck@sapserv.debis.de (Jan Wieck)