]> git.ipfire.org Git - thirdparty/bind9.git/commit
Parse and render rst syntax in :short: statement descriptions in tables
authorPetr Špaček <pspacek@isc.org>
Mon, 4 Jul 2022 10:33:04 +0000 (12:33 +0200)
committerPetr Špaček <pspacek@isc.org>
Mon, 4 Jul 2022 13:36:44 +0000 (15:36 +0200)
commit96691c5873d334ed87ecb231beccd40bd9698254
treeefb3f8d357d7f1f89e62ecbd21da309a9c533154
parent6ac047cfaa670a77b6f039e1c30c2b1f9af2d0e2
Parse and render rst syntax in :short: statement descriptions in tables

Without this change tables generated by .. namedconf:statementlist::
contained raw text and displayed rst syntax to users.

The raw docutil node returned by rst parser can contain unresolved
references (pending_xref nodes). We just store those nodes and let
Sphinx to resolve them later on.

Beware: This would not work if we injected nodes in later stages of
processing. All unresolved references must be in place before
'doctree-resolved' event is emitted (i.e. before resolve_references() is
called inside Sphinx).

(cherry picked from commit 62f3cf98d37ab629c38333c5fb9313872ac90cf0)
doc/arm/_ext/iscconf.py