Index: pykota/trunk/pykota/ipp.py
===================================================================
--- pykota/trunk/pykota/ipp.py (revision 3133)
+++ pykota/trunk/pykota/ipp.py (revision 3184)
@@ -24,4 +24,6 @@
 #
 #
+
+"""This module provides basic IPP request parsing facilities."""
 
 import sys
Index: pykota/trunk/pykota/dumper.py
===================================================================
--- pykota/trunk/pykota/dumper.py (revision 3166)
+++ pykota/trunk/pykota/dumper.py (revision 3184)
@@ -21,4 +21,6 @@
 #
 #
+
+"""This module handles all the data dumping facilities for PyKota."""
 
 import sys
Index: pykota/trunk/pykota/reporters/html.py
===================================================================
--- pykota/trunk/pykota/reporters/html.py (revision 3133)
+++ pykota/trunk/pykota/reporters/html.py (revision 3184)
@@ -22,4 +22,6 @@
 #
 #
+
+"""This module defines a class for HTML reporting."""
 
 import os
Index: pykota/trunk/pykota/reporters/text.py
===================================================================
--- pykota/trunk/pykota/reporters/text.py (revision 3133)
+++ pykota/trunk/pykota/reporters/text.py (revision 3184)
@@ -22,4 +22,6 @@
 #
 #
+
+"""This module defines a class for plain text reporting."""
 
 from pykota.reporter import BaseReporter
Index: pykota/trunk/pykota/storages/mysqlstorage.py
===================================================================
--- pykota/trunk/pykota/storages/mysqlstorage.py (revision 3183)
+++ pykota/trunk/pykota/storages/mysqlstorage.py (revision 3184)
@@ -23,4 +23,6 @@
 #
 #
+
+"""This module defines a class to access to a MySQL database backend."""
 
 import time
Index: pykota/trunk/pykota/storages/pgstorage.py
===================================================================
--- pykota/trunk/pykota/storages/pgstorage.py (revision 3182)
+++ pykota/trunk/pykota/storages/pgstorage.py (revision 3184)
@@ -22,4 +22,6 @@
 #
 #
+
+"""This module defines a class to access to a PostgreSQL database backend."""
 
 import time
Index: pykota/trunk/pykota/storages/sql.py
===================================================================
--- pykota/trunk/pykota/storages/sql.py (revision 3165)
+++ pykota/trunk/pykota/storages/sql.py (revision 3184)
@@ -22,4 +22,6 @@
 #
 #
+
+"""This module defines methods common to all relational backends."""
 
 from pykota.storage import StorageUser, StorageGroup, StoragePrinter, \
Index: pykota/trunk/pykota/storages/ldapstorage.py
===================================================================
--- pykota/trunk/pykota/storages/ldapstorage.py (revision 3168)
+++ pykota/trunk/pykota/storages/ldapstorage.py (revision 3184)
@@ -23,9 +23,10 @@
 #
 
-#
-# My IANA assigned number, for 
-# "Conseil Internet & Logiciels Libres, J�me Alet" 
-# is 16868. Use this as a base to create the LDAP schema.
-#
+"""This module defines a class to access to an LDAP database backend.
+
+My IANA assigned number, for 
+"Conseil Internet & Logiciels Libres, J�me Alet" 
+is 16868. Use this as a base to extend the LDAP schema.
+"""
 
 import sys
Index: pykota/trunk/pykota/storages/sqlitestorage.py
===================================================================
--- pykota/trunk/pykota/storages/sqlitestorage.py (revision 3183)
+++ pykota/trunk/pykota/storages/sqlitestorage.py (revision 3184)
@@ -22,4 +22,6 @@
 #
 #
+
+"""This module defines a class to access to a SQLite database backend."""
 
 import time
Index: pykota/trunk/pykota/cgifuncs.py
===================================================================
--- pykota/trunk/pykota/cgifuncs.py (revision 3133)
+++ pykota/trunk/pykota/cgifuncs.py (revision 3184)
@@ -20,4 +20,6 @@
 #
 
+"""This module defines some helper functions to use in CGI scripts."""
+
 import sys
 import os
Index: pykota/trunk/pykota/reporter.py
===================================================================
--- pykota/trunk/pykota/reporter.py (revision 3133)
+++ pykota/trunk/pykota/reporter.py (revision 3184)
@@ -23,4 +23,6 @@
 #
 
+"""This module defines bases classes used by all reporters."""
+
 import os
 import imp
@@ -46,13 +48,17 @@
         
     def getPrinterTitle(self, printer) :     
+        """Returns the formatted title for a given printer."""
         return (_("Report for %s quota on printer %s") % ((self.isgroup and "group") or "user", printer.Name)) + (" (%s)" % printer.Description)
         
     def getPrinterGraceDelay(self, printer) :    
+        """Returns the formatted grace delay for a given printer."""
         return _("Pages grace time: %i days") % self.tool.config.getGraceDelay(printer.Name)
         
     def getPrinterPrices(self, printer) :    
+        """Returns the formatted prices for a given printer."""
         return (_("Price per job: %.3f") % (printer.PricePerJob or 0.0), _("Price per page: %.3f") % (printer.PricePerPage or 0.0))
             
     def getReportHeader(self) :        
+        """Returns the correct header depending on users vs users groups."""
         if self.isgroup :
             return _("Group          overcharge   used    soft    hard    balance grace         total       paid warn")
@@ -61,4 +67,5 @@
             
     def getPrinterRealPageCounter(self, printer) :        
+        """Returns the formatted real page counter for a given printer."""
         msg = _("unknown")
         if printer.LastJob.Exists :
@@ -70,4 +77,5 @@
                 
     def getTotals(self, total, totalmoney) :            
+        """Returns the formatted totals."""
         return (_("Total : %9i") % (total or 0.0), ("%11s" % ("%7.2f" % (totalmoney or 0.0))[:11]))
             
Index: pykota/trunk/pykota/config.py
===================================================================
--- pykota/trunk/pykota/config.py (revision 3180)
+++ pykota/trunk/pykota/config.py (revision 3184)
@@ -22,4 +22,6 @@
 #
 #
+
+"""This module defines classes used to parse PyKota configuration files."""
 
 import os
Index: pykota/trunk/pykota/tool.py
===================================================================
--- pykota/trunk/pykota/tool.py (revision 3173)
+++ pykota/trunk/pykota/tool.py (revision 3184)
@@ -22,4 +22,6 @@
 #
 #
+
+"""This module defines the base classes for PyKota command line tools."""
 
 import sys
Index: pykota/trunk/pykota/logger.py
===================================================================
--- pykota/trunk/pykota/logger.py (revision 3133)
+++ pykota/trunk/pykota/logger.py (revision 3184)
@@ -23,4 +23,6 @@
 #
 
+"""This module defines base classes used by all logging backends."""
+
 import os
 import imp
Index: pykota/trunk/pykota/accounter.py
===================================================================
--- pykota/trunk/pykota/accounter.py (revision 3133)
+++ pykota/trunk/pykota/accounter.py (revision 3184)
@@ -22,4 +22,6 @@
 #
 #
+
+"""This module defines base classes used by all accounting methods."""
 
 import sys
Index: pykota/trunk/pykota/version.py
===================================================================
--- pykota/trunk/pykota/version.py (revision 3181)
+++ pykota/trunk/pykota/version.py (revision 3184)
@@ -22,4 +22,6 @@
 #
 
+"""This module defines some application level constants."""
+
 __version__ = "1.26alpha6_unofficial"
 
