
			    JavaPostgres95 0.3

		Copyright (c) 1996 Bradley McLean and Jeff Medeiros
		      Copyright (c) 1997 Peter T Mount
			    All Rights Reserved

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

    This program 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 General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

-------------------------------------------------------------------------------

This release is purely an update to the JDK 1.1 API. As such, it will not work
with pre 1.1 Virtual Machines.

As with 0.2, it does implement a useful subset of the JDBC 1.10 specification
- in particular, enough to do basic table manipulation over Postgres95.

REQUIREMENTS

You will need to be using the JDK 1.1 or later, and obviously Postgres95 or
PostgreSQL (the latter being the successor to PostgreSQL).

For Java in general, refer to http://www.javasoft.com
or for Java running on Linux go to http://www.blackdown.org/java-linux.html

PostgreSQL can be found at http://www.postgresql.org

The latest version of this driver and documentation will be available on my
web site: http://www.demon.co.uk/finder/postgres

INSTALLATION

Obviously, you've unpacked the archive.

Either move the postgres95 directory into your classpath, or add it's current
location to the classpath.

That's basically it.

You can test your installation by modifying the jptest*.java programs
to reflect your Postgres95 database and usernames, creating the
weather class specified in the Postgres95 documentation, compiling and
running the programs.

NOTES

 - Although Postgres95 is now called PostgreSQL, I haven't changed the
   package name to maintain compatibility with existing code.

 - RTFM! - Well to be polite, read the documentation that's included with
   the driver (Also available online). I'll guarantee you will need to read
   them, especially when you try to get Java applications to run over a
   network to a PostgreSQL server :-)

TO DO

 - Much of the meta information is an untested hackjob.

 - Cursor support is cursory.

 - This is not precisely excellent documentation.

 - It isn't *really* JDBC compliant, for a host of reasons.

SUMMARY

As Brad wrote in the 0.2 README:-
"I regret that I will not be able to provide extensive support for this
package, but I will integrate bug fixes, improvements and DOCUMENTATION
that I receive."

I can't provide extensive support for it either. However, it won't hurt
sending me an email if you have any problems, just don't expect an instant
response.

If you find (or even fix) any bugs, or find ways of improving them, PLEASE
send them to me so that I can keep the driver as up to date as possible.

Documentation will also be useful. And a copy will be on the web at the
following URL: http://www.demon.co.uk/finder/postgres

As always, THIS SOFTWARE IS SUPPLIED COMPLETELY "AS IS".  NO WARRANTY...

Peter T Mount
April 12 1997

email:	pmount@maidast.demon.co.uk
  WWW:	http://www.demon.co.uk/finder
Pager:	http://www.demon.co.uk/finder/misc/sms.html

