Docutils: Documentation Utilities Code

add expected for reference macros

Announce change to rst parser: warn for figure with no caption nor legend.

Cf. bugs #489.

typo

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.