confusing.  This is clearly Unix-specific; label it as such.

Unix-centric.  Note that this can be used with the output of
os.fstat() as well as os.stat() and os.lstat().

Run/Import, __main__.

databases (opened using hashopen()), as noted by Skip Montanaro on
comp.lang.python.

dramatically (up to 15 times he claims).  Works by reading more than
one line at a time, up to 100-line chunks (starting with one line and
then doubling up to the limit).  On a typical machine (e.g. Tim's
P5-166) this doesn't reduce interactive responsiveness in a noticeable
way.

the module being documented at that point in the documentation; these
are candidates for conversion to \refmodule, which produces a
hyperlink in the HTML and PDF versions of the output.

Use Python-traditional XXX comments instead of square brackets that
aren't as obvious or usefully grepable.

\op adds an optional parameter, and \p adds a required parameter.
These are only defined in the context of the parameter list parameter
of the envdesc and macrodesc environments.

compiler info.

All sections get reasonable file names in the HTML output.

elsewhere in the library reference.

Added "See also" reference to zlib home page, even though it's
mentioned in the text.

Make all references to the os module hyperlinks.

Added more information for cStringIO.

marked at all.

Make references to other modules hyperlinks.

example!

Two problems: The SMTPRecipientsRefused class should not inherit
SMTPResponseException, since it doesn't provide the smtp_code and
smtp_error attributes.  My patch for not adding an extra CRLF was
apparently forgotten.  The enclosed patch fixes these two problems.

Markup nits.

closing paragraph used \code).

method does _not_ disconnect the connection when it throws a
SMTPHeloError!