Python API documentation generation tool Code

- Added interpreted text directives to refer to external API.
- Epydoc HTML writer generates an index file suitable to be referred to.
- Added a script wrapping a Docutils HTML writer with external API reference
support.

- configuration file up-to-date with command line
- command line source code reformatted. Dropped those comments always
out of date...

- If there is no other info for a metadata variable, drop it as variable
- @newfield also add a metadata variable
- dropped __revision__ as alias for __version__. A new field can now be
defined.

- Documented the fact that consolidated list don't require the term
being interpreted text

- Added documentation for 'permission' field.

- Added variable docstring description (from the whatsnew).
- Added table for metadata variables.
- Added note about constructor parameters in class docstrings.

- Fixed reST URL.

- Added new features.
- There's a beta, there's a february...

- Added Docutils url
- Fixed reST capitalization

- All the markup error solved.