Docutils: Documentation Utilities Code

Fix formatting

Store attribute values with datatype "yesorno" as `bool` values.

Use `bool` instead of `int` to store values of "yesorno" attributes in
Python doctree element instances.
This is the "natural" choice for "yesorno" and restores consistency
with the validating function `nodes.validate_yesorno()`.

In XML and pseudoxml output, the value is serialized as "0" or "1"
for backwards compatibility.

manpage image handling redo

remove warnings suppression from std tests

test manpage warning on image content

Catch deliberate system messages when running the test suite.

When we know a test case triggers a system message,
make sure that it does not clutter the output.

System messages that are only printed to the warning stream may
be checked in an `assertRaisesRegex()` block after setting the "halt_level"
configuration setting to a matching level (cf. e.g. "test_nodes.py"
or the "test/*/test_*_misc.py" test modules).

Trim down overhead of type hints.

get_(reader|parser|writer)class():
Don't use @overload for individual values of the same type that return
a class that is a subclass of a well defined abstract base class.

docutils.nodes:
There is no need to add a TypeVar for the type of a default value when
the alternative is any ``Any | _DefaultT``.

Cf. patches #212.

Small fixes and additions.

Be more specific in FAQ answer.

Don't list minor fix (bug #287) in HISTORY.

Shorten some docstrings to adhere to documentation policy
(multi-line docstrings should be summary line, blank line, details).

Better name for function factory that returns a keyword validating function.
(cf. https://stackoverflow.com/questions/3368830/how-to-name-factory-like-methods).

Fix attribute name mismatch "autonum" -> "auto".

Explain F401 noqa comment.

Fix typo in "writers/html5_polyglot/minimal.css" stylesheet.

Avoid confusing variable name ``twidth`` in latex writer.

move manpage image TODO into test_writers/test_manpage

ODT writer: Fix handling of `*.xml` stylesheets.

According to the ODT writer documentation, the "stylesheet" setting
should work with either "styles.odt" or "styles.xml" files.

Fix errors with "*.xml" style files [bugs:#494].
Thanks to Paul Kishimoto for report and analysis.