Better docstrings for lib/ modules.

lib/extensions.py

@@ -1,12 +1,11 @@
-"""
-psycopg extensions to the DBAPI-2.0
+"""psycopg extensions to the DBAPI-2.0
 
-This module holds all the extensions to the DBAPI-2.0 provided by psycopg:
+This module holds all the extensions to the DBAPI-2.0 provided by psycopg.
 
     connection -- the new-type inheritable connection class
     cursor -- the new-type inheritable cursor class
     adapt() -- exposes the PEP-246 compatile adapting machanism used
-     by psycopg to adapt Python types to PostgreSQL ones
+    by psycopg to adapt Python types to PostgreSQL ones
 """
 # psycopg/extensions.py - DBAPI-2.0 extensions specific to psycopg
 #

lib/extras.py

@@ -1,6 +1,6 @@
-"""Miscellaneous goodies for psycopg
+"""Miscellaneous goodies for psycopg2
 
-This module is a generic place used to hold little helper function
+This module is a generic place used to hold little helper functions
 and classes untill a better place in the distribution is found.
 """
 # psycopg/extras.py - miscellaneous extra goodies for psycopg

lib/psycopg1.py

@@ -2,9 +2,9 @@
 
 This module uses the new style connection and cursor types to build a psycopg
 1.1.1.x compatibility layer. It should be considered a temporary hack to run
-old code hile porting to psycopg 2. Import as follows:
+old code hile porting to psycopg 2. Import it as follows:
 
-    from psycopg import psycopg1 as psycopg
+    from psycopg2 import psycopg1 as psycopg
 """
 # psycopg/psycopg1.py - psycopg 1.1.x compatibility module
 #

lib/tz.py

@@ -1,3 +1,9 @@
+"""tzinfo implementations for psycopg2
+
+This module holds twi different tzinfo implementations that can be used as
+the 'tzinfo' argument to datetime constructors, directly passed to psycopg
+functions or used to set the .tzinfo_factory attribute in cursors. 
+"""
 # psycopg/tz.py - tzinfo implementation
 #
 # Copyright (C) 2003-2004 Federico Di Gregorio  <fog@debian.org>