summary refs log tree commit diff stats
path: root/scripts/qapi/main.py
diff options
context:
space:
mode:
authorJohn Snow <jsnow@redhat.com>2025-03-10 23:42:57 -0400
committerMarkus Armbruster <armbru@redhat.com>2025-03-11 10:26:52 +0100
commit4d7d30b405a16d85ede6184595e8001fe2c412c4 (patch)
treea83c9a7c5b698744639528ea921def93622ab858 /scripts/qapi/main.py
parent565274da10fe46bf8c30a8175e39753e4fedb60e (diff)
downloadfocaccia-qemu-4d7d30b405a16d85ede6184595e8001fe2c412c4.tar.gz
focaccia-qemu-4d7d30b405a16d85ede6184595e8001fe2c412c4.zip
qapi/parser: add undocumented stub members to all_sections
Parser and doc generator cooperate on generating stub documentation for
undocumented members.  The parser makes up an ArgSection with an empty
description, and the doc generator makes up a description.

Right now, the made-up ArgSections go into doc.args.  However, the new
doc generator uses .all_sections, not .args.  So put them into
.all_sections, too.

Insert them right after existing 'member' sections.  If there are none,
insert directly after the leading section.

Doesn't affect the old generator, because that one doesn't use
.all_sections.

Signed-off-by: John Snow <jsnow@redhat.com>
Message-ID: <20250311034303.75779-60-jsnow@redhat.com>
Reviewed-by: Markus Armbruster <armbru@redhat.com>
[Commit message rewritten]
Signed-off-by: Markus Armbruster <armbru@redhat.com>
Diffstat (limited to 'scripts/qapi/main.py')
0 files changed, 0 insertions, 0 deletions