Python API documentation generation tool Code

- Use raw string for TEMPLATE

- Added note to self

- Incorporated (and extended) patches from Jonathan Guyer, to move
formatting decisions for the latex writer into a separate
stylesheet. The new version is not compatible with Jonathan
Guyer's original patch -- I redesigned the interface between
epydoc.docwriter.latex and the stylesheet somewhat. At present,
three style files are available: 'base', 'boxes', and 'shaded'.
'boxes' resembles the old (3.0) output.

- Fixed minor bug in handling of markup like `foo <bar>`

- Added "--inheritance hidden" to not list inherited vars at all.

- Use 'show_private' option to specify whether to show/hide private vars.

NOTE: This changes the default behavior of that latex writer.
Previously, it hid private vars by default; now it will show
them by default.

- If we're using introspection, then import everything that we plan to
document before we start introspecting anything. This can be important
if one module modifies another. The bug that inspired this fix was
sf bug #1896919.

- Fixed typo in error message

- When constructing UML graph nodes, guard against the case where
class_doc.sorted_variables is UNKNOWN. This is known to happen
if the user defines a class that subclasses from an undocumented
class that itself has a nested class. E.g., Tkinter.Misc.getint.

- In mro calculation: if there's an inconsistent base class hierarchy,
then print an error and recover using depth first search.