[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PATCH 03/23] docs/qapidoc: remove example section support
From: |
John Snow |
Subject: |
[PATCH 03/23] docs/qapidoc: remove example section support |
Date: |
Thu, 12 Dec 2024 21:18:06 -0500 |
Since 3c5f6114 we no longer actually generate Example sections, so this
support in qapidoc is now dead code.
Signed-off-by: John Snow <jsnow@redhat.com>
---
docs/sphinx/qapidoc.py | 9 +--------
1 file changed, 1 insertion(+), 8 deletions(-)
diff --git a/docs/sphinx/qapidoc.py b/docs/sphinx/qapidoc.py
index 5a4d7388b29..61997fd21af 100644
--- a/docs/sphinx/qapidoc.py
+++ b/docs/sphinx/qapidoc.py
@@ -254,10 +254,6 @@ def _nodes_for_features(self, doc):
section += dlnode
return [section]
- def _nodes_for_example(self, exampletext):
- """Return list of doctree nodes for a code example snippet"""
- return [nodes.literal_block(exampletext, exampletext)]
-
def _nodes_for_sections(self, doc):
"""Return list of doctree nodes for additional sections"""
nodelist = []
@@ -275,10 +271,7 @@ def _nodes_for_sections(self, doc):
continue
snode = self._make_section(section.tag)
- if section.tag.startswith('Example'):
- snode += self._nodes_for_example(dedent(section.text))
- else:
- self._parse_text_into_node(dedent(section.text), snode)
+ self._parse_text_into_node(dedent(section.text), snode)
nodelist.append(snode)
return nodelist
--
2.47.0
- [PATCH 00/23] docs: add basic sphinx-domain rST generator to qapidoc, John Snow, 2024/12/12
- [PATCH 01/23] docs/qapidoc: support header-less freeform sections, John Snow, 2024/12/12
- [PATCH 03/23] docs/qapidoc: remove example section support,
John Snow <=
- [PATCH 02/23] qapi/parser: adjust info location for doc body section, John Snow, 2024/12/12
- [PATCH 04/23] qapi: expand tags to all doc sections, John Snow, 2024/12/12
- [PATCH 05/23] qapi/schema: add __repr__ to QAPIDoc.Section, John Snow, 2024/12/12
- [PATCH 06/23] docs/qapidoc: add transmogrifier stub, John Snow, 2024/12/12
- [PATCH 07/23] docs/qapidoc: add transmogrifier class stub, John Snow, 2024/12/12