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

docs/qapi-domain: add :unstable: directive option

Browse source 
Although "unstable" is a feature (and *will* appear in the features
list), add a special :unstable: option to generate an eye-catch that
makes this information very hard to miss.

The forthcoming Transmogrifier in qapidoc.py will add this option
whenever it detects that the features list attached to a definition
contains the "unstable" entry.

Signed-off-by: Harmonie Snow <harmonie@gmail.com>
Signed-off-by: John Snow <jsnow@redhat.com>
Message-ID: <20250311034303.75779-25-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:22 -04:00 • committed by Markus Armbruster
parent 1a0c090a5b
commit d25808c2bc
2 changed files with 13 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

8
docs/sphinx/qapi_domain.py
View file

@ -218,6 +218,7 @@ class QAPIObject(QAPIDescription):
# These are QAPI originals:
"since": directives.unchanged,
"deprecated": directives.flag,
"unstable": directives.flag,
}
)
@ -300,6 +301,13 @@ class QAPIObject(QAPIDescription):
"qapi-deprecated",
)
if "unstable" in self.options:
_add_pip(
":unstable:",
f"This {self.objtype} is unstable/experimental.",
"qapi-unstable",
)
if infopips.children:
contentnode.insert(0, infopips)