Python API documentation generation tool Code

- The parse representation is preferred if repr() returns a stock result,
i.e. something like '<ClassName instance at 0x12345678>'.
- Using LaTeX package fancyhdr instead of the deprecated fancyheadings.
- Added missing escaping of LaTeX parameter default.
- Dropped parse_repr/pyval_repr check in HTML parameters default.

- Docstring fixed.

- Fixed docstring typo

- Warn if @type is used in a bad context.

- Removed unnecessary <code class="pyval">...</pyval> wrapping element
from the output of the PyvalColorizer.

- Modified pyval_repr.py so now it generates a ParsedEpydocDocstring
as its output. This should make it possible to change
APIDoc.pyval_repr to return a ParsedDocstring instead of a str.
This ParsedDocstring would be the result of colorization via
pyval_repr, with the parsed repr as a fallback.

- Added preliminary repr tests

- Refactored some test functions

- Added a new module for colorizing python values. This abstracts away
from the code that's currently in the html writer, and should make it
easier to use the same colorization code for other docwriters. The
new code should do a better job of pretty-printing values than the
current html writer code. I also fixed a couple minor bugs in the
regexp colorizer along the way.

Note, though, that this code hasn't been plugged into epydoc in any
way yet. I.e., docwriter/html.py still needs to be modified to actually
*use* this new code.

- Added options to control return value::

--fail-on-error
--fail-on-warning
--fail-on-docstring-warning

All three options cause epydoc to exit with status 1 if a message of
the indicated level or higher is generated. This can be useful for
e.g., incorperation into makefiles. (See sf bug 1558792)