motorhead/qemu
1
0
Fork 0
mirror of https://github.com/Motorhead1991/qemu.git synced 2025-07-28 21:03:54 -06:00
Code Issues Projects Releases Packages Wiki Activity Actions

docs/qapi-domain: add compatibility node classes

Browse source 
Sphinx prior to v4.0 uses different classes for rendering elements of
documentation objects; add some compatibility classes to use the right
node classes conditionally.

Signed-off-by: John Snow <jsnow@redhat.com>
Message-ID: <20250311034303.75779-10-jsnow@redhat.com>
Acked-by: Markus Armbruster <armbru@redhat.com>
Signed-off-by: Markus Armbruster <armbru@redhat.com>
This commit is contained in:
John Snow 2025-03-10 23:42:07 -04:00 • committed by Markus Armbruster
parent 760b37e1df
commit 6d64a27cd3
1 changed files with 16 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

17
docs/sphinx/compat.py
View file

@ -2,12 +2,27 @@
Sphinx cross-version compatibility goop Sphinx cross-version compatibility goop
""" """
from docutils.nodes import Element from typing import Callable
from docutils.nodes import Element, Node, Text
import sphinx
from sphinx import addnodes
from sphinx.util import nodes from sphinx.util import nodes
from sphinx.util.docutils import SphinxDirective, switch_source_input from sphinx.util.docutils import SphinxDirective, switch_source_input
SpaceNode: Callable[[str], Node]
KeywordNode: Callable[[str, str], Node]
if sphinx.version_info[:3] >= (4, 0, 0):
SpaceNode = addnodes.desc_sig_space
KeywordNode = addnodes.desc_sig_keyword
else:
SpaceNode = Text
KeywordNode = addnodes.desc_annotation
def nested_parse_with_titles( def nested_parse_with_titles(
directive: SphinxDirective, content_node: Element directive: SphinxDirective, content_node: Element
) -> None: ) -> None: