diff options
| author | John Snow <jsnow@redhat.com> | 2024-07-03 13:52:35 -0400 |
|---|---|---|
| committer | John Snow <jsnow@redhat.com> | 2024-07-12 16:46:21 -0400 |
| commit | dd23f9ec519db9c424223cff8767715de5532718 (patch) | |
| tree | f085e0a4c4085f5cc047aaafd6bb65ae591e06fc /docs/sphinx/hxtool.py | |
| parent | fe791b7fcc760cd332cfabe5a328bc63e0437aa4 (diff) | |
| download | focaccia-qemu-dd23f9ec519db9c424223cff8767715de5532718.tar.gz focaccia-qemu-dd23f9ec519db9c424223cff8767715de5532718.zip | |
docs: remove Sphinx 1.x compatibility code
In general, the Use_SSI workaround is no longer needed, and neither is the pre-1.6 logging shim for kerneldoc. Signed-off-by: John Snow <jsnow@redhat.com> Acked-by: Markus Armbruster <armbru@redhat.com> Reviewed-by: Thomas Huth <thuth@redhat.com> Message-id: 20240703175235.239004-3-jsnow@redhat.com [rebased on top of origin/master. --js] Signed-off-by: John Snow <jsnow@redhat.com>
Diffstat (limited to 'docs/sphinx/hxtool.py')
| -rw-r--r-- | docs/sphinx/hxtool.py | 21 |
1 files changed, 4 insertions, 17 deletions
diff --git a/docs/sphinx/hxtool.py b/docs/sphinx/hxtool.py index 3729084a36..a84723be19 100644 --- a/docs/sphinx/hxtool.py +++ b/docs/sphinx/hxtool.py @@ -24,16 +24,10 @@ from docutils import nodes from docutils.statemachine import ViewList from docutils.parsers.rst import directives, Directive from sphinx.errors import ExtensionError +from sphinx.util.docutils import switch_source_input from sphinx.util.nodes import nested_parse_with_titles import sphinx -# Sphinx up to 1.6 uses AutodocReporter; 1.7 and later -# use switch_source_input. Check borrowed from kerneldoc.py. -Use_SSI = sphinx.__version__[:3] >= '1.7' -if Use_SSI: - from sphinx.util.docutils import switch_source_input -else: - from sphinx.ext.autodoc import AutodocReporter __version__ = '1.0' @@ -185,16 +179,9 @@ class HxtoolDocDirective(Directive): # of title_styles and section_level that kerneldoc.py does, # because nested_parse_with_titles() does that for us. def do_parse(self, result, node): - if Use_SSI: - with switch_source_input(self.state, result): - nested_parse_with_titles(self.state, result, node) - else: - save = self.state.memo.reporter - self.state.memo.reporter = AutodocReporter(result, self.state.memo.reporter) - try: - nested_parse_with_titles(self.state, result, node) - finally: - self.state.memo.reporter = save + with switch_source_input(self.state, result): + nested_parse_with_titles(self.state, result, node) + def setup(app): """ Register hxtool-doc directive with Sphinx""" |