Python API documentation generation tool Code

- Updated doctests for APIDoc

- Fixed bug: valdocs was used before it was defined

Fixed spelling error (supress -> suppress)

Supress docstring warnings for any objects that are not included in
the documented set. This includes inherited values and variables,
*unless* they are overridden, in which case the docstring may be
inherited.

- Added supress_warnings param for parse_docstrings -- contains a set of
apidocs for which warnings should be supressed.

- Added 'overrides' filter, which is False by default.

- Applied sourceforge patch #1678242 -- added command-line option
'-src-code-tab-width'.

- Applied sourceforge patch #1723597 -- convert imported names
to global names before adding them to ModuleDoc.imports.

- Fixed sourceforge bug #1837874 -- fix_self_shadowing_var was setting
canonical_name to a tuple by accident.
- Fixed typo introduced by previous svn checkin in _inherit_info()
- Made warning for introspector/parser disagreements about submodules
a little prettier.

- For run_subprocess() on py <2.3 non-unix systems, read stdout before
reading stderr, as suggested by sourceforge bug #1838649.