[Docutils-develop] Updates to Docutils

[David G. <go...@us...>]

I just checked in a reworking of the "system message" reporting mechanism,
for better diagnostics.  Now almost all messages will have a source
("filename" or "<stdin>" etc.) and line number attached.  Previously, line
numbers were only attached to errors reported during the parse, none from
the transforms.  I'm sure there are some cases I've missed, so I'd
appreciate any testing and bug reports.

At the same time, I changed the output format.  The old format was like
this::

    Reporter: ERROR/3 (filename, line 3) Unexpected indentation.

The new format follows the GNU-Tools standard::

    filename:3: (ERROR/3) Unexpected indentation.

This format is understood by many tools so it should make the Reporter
output more useful.  Thanks to Skip Montanaro for the idea.

Gunnar, this change will probably affect DocFactory.  I've bumped Docutils'
version number to 0.2.5 for this change, so DocFactory can check it.  See
tools/pep2html.py for one implementation of a version check.

-- 
David Goodger  <go...@us...>  Open-source projects:
  - Python Docutils: http://docutils.sourceforge.net/
    (includes reStructuredText: http://docutils.sf.net/rst.html)
  - The Go Tools Project: http://gotools.sourceforge.net/