This is a binary installation package for the PyGreSQL extension module 
for Python, version 3.3, built for the OS/2+EMX port of Python 2.3.

PyGreSQL is an interface to the PostgreSQL RDBMS package, and includes 
a Python DB-API 2.0 compatible wrapper module.

The source archive (PostgreSQL-7.2.3.tar.gz) this package is based on 
was found at
  http://www.postgresql.org/

This package can be used to connect to Vincenzo Venuto's OS/2 EMX port 
of the PostgreSQL RDBMS, from http://www.ecomstation.it/postgres/.
PostgreSQL doesn't need to be either running or installed on the machine 
which uses this module, as this module is staticly linked against 
PostgreSQL's libpq interface library.

Note that although the Venuto PostgreSQL port includes SSL support in 
the interface libraries, which may also be available in other installations 
of PostgreSQL, this package doesn't include SSL support.

  NOTE:
  =====
  Because libpq's default build assumes a Unix host, connections default 
  to attempting to connect to a local instance of PostgreSQL via Unix 
  domain (AF_UNIX) sockets - which the EMX runtime doesn't support.

  _ALWAYS_ specify a hostname of "localhost" when connecting to a 
  PostgreSQL instance on the same machine so that the module uses 
  TCP/IP (AF_INET) sockets to connect to the database.
  =====

Please refer to the PyGreSQL.README file for more information about the 
PyGreSQL module.

This module was built with no changes to the PyGreSQL source code, and 
the only modification to the Distutils setup.py script was to add 
information about library names and locations.  The underlying libpq 
library was built with no source changes and an EMX multithread 
specific Makefile.  I have chosen to install the PyGreSQL package in 
%PYTHONHOME%/Lib/site-packages/PyGreSQL, rather than the standard
%PYTHONHOME%/Lib/site-packages, to minimise confusion with other 
PostgreSQL interface modules.  The libraries in Venuto's packages 
are also single-threaded only, which is why I've rebuilt the static 
libraries.

You need the Python 2.3 port installed before you can install this 
package - you should be able to get it where you obtained this 
archive.

To install (assuming a working Python installation), change to the 
directory containing the install script (install.cmd), and execute the 
script.

Please let me know if you encounter any problems with the installation 
package.  Bug reports about PyGreSQL should be directed as specified on 
the PostgreSQL home page.

This software is provided 'as-is', without any express or implied warranty.
In no event will the packager be held liable for any damages arising from 
the use of the software.

Andrew MacIntyre
andymac@bullseye.apana.org.au
http://www.andymac.org/
August 3, 2003.
