Docutils: Documentation Utilities Code

manpage writer:

- Use .MT/.ME macros for mailto.uris.
- Do not output .UR/.UE macros if refuri is not set

XML parser: register substitution definitions.

Call `nodes.note_substitution_def()` for every `<substitution_definition>`
to update the list of substitution definitions.
(The `references.Substitution` transform relies on this list.)

Announce upcoming change in "doctest block" handling.

Parse doctest blocks as "code" with language "pycon" (pygment name for
Python console).

+1 syntax highlight in line with other "code" elements.
+1 the `<doctest_block>` doctree element can be retired.

Fix internal "line" attribute of the `<doctest_block>` node.

Patch #211 by Hood Chatham.

Change extension of the local GPL 3 license copy back to ``.txt``.

The document format is text but not reStructuredText.

(Other license text files are rST compatible.)

Remove `docutils/utils/roman.py`.

Obsoleted by ``docutils/utils/_roman_numerals.py``.

One more Document Tree documentation review.

Rephrase and reformat for more brevity and clarity.
Fix typos, add crosslinks.

Less gaudy colors in the element hierarchy diagram.

Make the "Element Reference" introduction a sub-section,
so it turns up in the local ToC.

Update analogies to HTML (now referring to HTML5 rsp. the "living standard").
Fix analogy to `<h1>` to `<h6>`: these mark titles (headings), not sections.

Reduce redundancy: Only list including "Parameter Entities" if not
implied by the element category).

Update description of `<line-block>` (it used to be a
sort of literal-block but is is now rather a plain list,
cf. docs/dev/rst/alternatives.html#syntax-for-line-blocks).

Small section for "placeholder" parameter entities.

Move the description of "Pseudo-XML" and the "Names and identifiers"
section content to a new "Glossary" section.

Bibliography entry for docutils.dtd.

Small fix for target-highlight in "responsive" stylesheet (HTML5).

Highlight complete citation, not only the label.

Wrap setting the default "locale" in try/except, report locale.Error as warning.

Docutils command line tools use `locale.setlocale()` to set the locale to the user's
default locale. This may lead to a `locale.Error` if there are problems in the
systems locale setup. As locale settings are not critical for the working of
Docutils (but may affect the output in certain instances), we now clear the
exception and report a WARNING.

Fixes bug #495.

rename .txt to .rst (left over)