PostgreSQL access from the Scheme Shell              -*-indented-text-*-
=======================================

   This module lets you access the PostgreSQL object-relational DBMS
   from within the Scheme Shell. It implements the client part of the
   socket-level frontend/backend protocol, rather than providing a
   wrapper around the libpq library. The module is capable of type
   coercions from a range of SQL types to the equivalent Scheme type,
   and now supports large objects (BLOBs).


Installing ==========================================================

   This library runs under Olin Shivers' Scheme Shell, which adds many
   useful things like sockets, a POSIX interface, records, a module
   system and error handling to Scheme. Scsh can be obtained from

       <URL:http://www.scsh.net>

   To install this package under Scsh, use Michel Schinz's Installation
   Library available from

   http://lamp.epfl.ch/~schinz/scsh_packages/

   Running the installation script ("scsh-install-pkg") in this
   directory will automatically install and setup the library.

   The distribution includes a test file which is executable from the
   command line, and which shows how to use the library via the
   Scheme48 module system.

   NB: The postgres backend must be started with the "-i" argument in
   order to allow TCP/IP connections; they are disallowed with the
   default setup.


Availability ==========================================================

   Copyright (C) 1999 Eric Marsden
   Copyright (C) 2006, 2007  Emilio C. Lopes

   This library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Lesser General Public
   License as published by the Free Software Foundation; either
   version 2.1 of the License, or (at your option) any later version.

   This library is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
   Lesser General Public License for more details.

   You should have received a copy of the GNU Lesser General Public
   License along with this library; if not, write to the Free Software
   Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA


   Tested with Scsh 0.6.7 on Debian GNU/Linux 3.1 and PostgreSQL
   versions 7.4.7 and 8.1.5.  Please send bug reports, suggestions and
   questions to <eclig@gmx.net>. This is version 0.3. The latest
   version should be available from

       <URL:http://home.tiscali.de/emilio.lopes/scheme/>


Emilio Lopes, 2006-12-26
