Clean up of the module docstring.
This includes whitespace fixes, punctuation fixes, spelling fixes, and fixes for the epydoc format.
Authored by: bugman 2008-10-16
Parent: [r7745]
Child: [r7747]
