More documentation updates.

James William Pye · James William Pye · commit 3f620a541a38 · 2009-04-03T03:09:37.000-07:00
diff --git a/postgresql/__init__.py b/postgresql/__init__.py
@@ -32,15 +32,15 @@
 
 ##
 # IRI to base reference documentation.
-__pkg_documentation__ = __project_id__ + '/v' + '.'.join([
+__pkg_documentation__ = __project_id__ + '/docs/' + '.'.join([
 	str(x) for x in version_info[:2]
 ]) + '/'
 
 pg_iri = pg_driver = pg_param = None
 def open(iri = None):
 	"""
 	Create a `postgresql.api.Connection` to the server referenced by the given
-	`iri` keyword::
+	`iri`::
 
 		>>> import postgresql
 		# General Format:
diff --git a/postgresql/documentation/changes.py b/postgresql/documentation/changes.py
@@ -6,7 +6,7 @@
 Changes
 =======
 
-0.8.0 released on 2009-04-02
+0.8.0 released on 2009-04-03
 ----------------------------
 
 Differences from the original pg/python projects.
@@ -26,7 +26,9 @@
  * Conditionally DECLARE certain cursors WITH HOLD when outside of blocks.
  * Add typed support for fetches from db.cursor_from_id().
  * Change the test infrastructure to automatically create a cluster.
+ * More improvements than I can remember.
 """
+
 __docformat__ = 'reStructuredText'
 if __name__ == '__main__':
 	import sys
diff --git a/postgresql/release/distutils.py b/postgresql/release/distutils.py
@@ -23,17 +23,26 @@
 
 LONG_DESCRIPTION = """
 py-postgresql is a set of Python modules providing interfaces to various parts
-of PostgreSQL. Notably, it provides a driver for querying a PostgreSQL database.
+of PostgreSQL. Notably, it provides a pure-Python driver + C optimizations for
+querying a PostgreSQL database.
 
-Sample PG-API Code
-------------------
+http://python.projects.postgresql.org
+
+Features:
+
+ * Prepared Statement driven interfaces.
+ * Cluster tools for creating and controlling a cluster.
+ * Support for most PostgreSQL types: composites, arrays, numeric, lots more.
+ * COPY support.
+
+Sample PG-API Code::
 
-	>>> import postresql
+	>>> import postgresql
 	>>> db = postgresql.open('pq://user:password@host:port/database')
 	>>> db.execute("CREATE TABLE emp (emp_first_name text, emp_last_name text, emp_salary numeric)")
 	>>> make_emp = db.prepare("INSERT INTO emp VALUES ($1, $2, $3)")
 	>>> make_emp("John", "Doe", "75,322")
-	>>> with db.xact:
+	>>> with db.xact():
 	...  make_emp("Jane", "Doe", "75,322")
 	...  make_emp("Edward", "Johnson", "82,744")
 	...
@@ -44,7 +53,7 @@
 
 However, PG-API is recommended as it provides greater utility.
 
-Once you get it installed, try out the ``pg_python`` command::
+Once installed, try out the ``pg_python`` console script::
 
 	$ pg_python -h localhost -p port -U theuser -d database_name
 
@@ -56,14 +65,8 @@
 -------
 
 py-postgresql is not yet another PostgreSQL driver, it's been in development for
-years. py-postgresql is the Python 3.0 port of the ``pg_proboscis`` driver and
+years. py-postgresql is the Python 3 port of the ``pg_proboscis`` driver and
 integration of the other ``pg/python`` projects.
-
-
-More Information
-----------------
-
-http://python.projects.postgresql.org
 """
 
 CLASSIFIERS = [
@@ -157,7 +160,7 @@ def standard_setup_keywords(build_extensions = True, prefix = default_prefix):
 	d = {
 		'name' : name,
 		'version' : version,
-		'description' : 'PostgreSQL tools pacakges. Driver, API specifications, and cluster tools.',
+		'description' : 'PostgreSQL driver and tools library.',
 		'long_description' : LONG_DESCRIPTION,
 		'author' : 'James William Pye',
 		'author_email' : 'x@jwp.name',
