Python API documentation generation tool Code

- Fixed a minor bug introduced in svn 1704

- Fixed typo from previous checkin

- Deregister loggers before cli.main() exits.
- Rearranged logger handling code in cli, to better handle the case
where multiple loggers are used.

- Added support for @public decorator, which is assumed to append a
function's name to __all__. This can be turned off with the
configuration constant PUBLIC_DECORATOR_APPENDS_TO_ALL.

- Pass options to plaintext writer

- Added support for show_private option to plaintext writer

- Added parsing support for:
>>> __all__.append('name')
>>> __all__ += ['name']
- Added line numbers to parser warning messages

- Minor change in help string for --suppress-timestamp

- Added --suppress-timestamp option (sf feature request 1695848)

- When parsing a file for documentation, if an IOError or OSError
is encountered then issue an error message rather than crashing.
E.g., this occurs if a permission issue prevents epydoc from
reading a python source file. (sf bug 1883053)