motorhead/qemu
1
0
Fork 0
mirror of https://github.com/Motorhead1991/qemu.git synced 2025-07-27 04:13:53 -06:00
Code Issues Projects Releases Packages Wiki Activity Actions

docs/qapidoc: add visit_paragraph() method

Browse source 
This transforms "formerly known as untagged sections" into our pure
intermediate rST format. These sections are already pure rST, so this
method doesn't do a whole lot except ensure appropriate newlines.

Signed-off-by: John Snow <jsnow@redhat.com>
Message-ID: <20250311034303.75779-45-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:42 -04:00 • committed by Markus Armbruster
parent 803df114fd
commit 56e1adf293
1 changed files with 9 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

9
docs/sphinx/qapidoc.py
View file

@ -130,6 +130,15 @@ class Transmogrifier:
# Transmogrification helpers
def visit_paragraph(self, section: QAPIDoc.Section) -> None:
# Squelch empty paragraphs.
if not section.text:
return
self.ensure_blank_line()
self.add_lines(section.text, section.info)
self.ensure_blank_line()
def preamble(self, ent: QAPISchemaDefinition) -> None:
"""
Generate option lines for QAPI entity directives.