Minor cleanups.

James William Pye · James William Pye · commit 97ce7b84b903 · 2009-04-03T02:40:09.000-07:00
diff --git a/README b/README
@@ -43,6 +43,8 @@ The documentation package, `postgresql.documentation.index`, contains more
 detailed information on the modules herein, and HTML versions of the
 documentation can be found at::
 
+
 	http://python.projects.postgresql.org
 
+
 Or, you can read them in your pager: python -m postgresql.documentation.index
diff --git a/postgresql/documentation/driver.py b/postgresql/documentation/driver.py
@@ -17,6 +17,9 @@
 version 3.0 of the PQ protocol *should* work, many features may not work due to
 absent functionality in the remote end.
 
+For DB-API 2.0 users, the driver module is located at
+`postgresql.driver.dbapi20`.
+
 .. note::
    PostgreSQL versions 8.1 and earlier do not support standard conforming
    strings. A warning will be raised whenever a connection is established to a
diff --git a/postgresql/documentation/index.py b/postgresql/documentation/index.py
@@ -8,10 +8,11 @@
 =============
 
 py-postgresql is a project dedicated to improving the Python interfaces to
-PostgreSQL.
+PostgreSQL. It strives to provide substantial convenience to Python programmers
+using PostgreSQL.
 
 At its core, py-postgresql provides a PG-API, `postgresql.api`, and
-DB-API 2.0 interface for accessing a PostgreSQL database.
+DB-API 2.0 interface for using a PostgreSQL database.
 
 --------
 Contents
@@ -40,27 +41,29 @@
 Sample PG-API Code
 ------------------
 
+Using `postgresql.driver`::
+
 	>>> import postgresql
 	>>> db = postgresql.open("pq://user:password@host/name_of_database")
 	>>> db.execute("CREATE TABLE emp (emp_name text PRIMARY KEY, emp_salary numeric)")
-   >>>
+	>>>
 	>>> # Create the statements.
 	>>> make_emp = db.prepare("INSERT INTO emp VALUES ($1, $2)")
 	>>> raise_emp = db.prepare("UPDATE emp SET emp_salary = emp_salary + $2 WHERE emp_name = $1")
 	>>> get_emp_with_salary_lt = db.prepare("SELECT emp_name FROM emp WHERE emp_salay < $1")
-   >>>
+	>>>
 	>>> # Create some employees, but do it in a transaction--all or nothing.
 	>>> with db.xact():
 	...  make_emp("John Doe", "150,000")
 	...  make_emp("Jane Doe", "150,000")
 	...  make_emp("Andrew Doe", "55,000")
 	...  make_emp("Susan Doe", "60,000")
-   >>>
+	>>>
 	>>> # Give some raises
 	>>> with db.xact():
 	...  for row in get_emp_with_salary_lt("125,000"):
-   ...   print(row["emp_name"])
-   ...   raise_emp(row["emp_name"], "10,000")
+	...   print(row["emp_name"])
+	...   raise_emp(row["emp_name"], "10,000")
 
 
 Of course, if DB-API 2.0 is desired, the module is located at
diff --git a/sphinx-src/index.rst b/sphinx-src/index.rst
@@ -2,10 +2,11 @@ py-postgresql
 =============
 
 py-postgresql is a project dedicated to improving the Python interfaces to
-PostgreSQL.
+PostgreSQL. It strives to provide substantial convenience to Python programmers
+using PostgreSQL.
 
 At its core, py-postgresql provides a PG-API, `postgresql.api`, and
-DB-API 2.0 interface for accessing a PostgreSQL database.
+DB-API 2.0 interface for using a PostgreSQL database.
 
 
 Contents
@@ -25,6 +26,8 @@ Contents
 Sample PG-API Code
 ------------------
 
+Using `postgresql.driver`::
+
    >>> import postgresql
    >>> db = postgresql.open("pq://user:password@host/name_of_database")
    >>> db.execute("CREATE TABLE emp (emp_name text PRIMARY KEY, emp_salary numeric)")
