aboutsummaryrefslogtreecommitdiff
path: root/docs/devel
diff options
context:
space:
mode:
authorJohn Snow <jsnow@redhat.com>2025-03-13 00:43:05 -0400
committerMarkus Armbruster <armbru@redhat.com>2025-03-14 07:31:57 +0100
commit9ca404f0043d63043bfed3af8da3adedc062cb13 (patch)
treeba485ea777cd2a519460a750685e6e26b037c304 /docs/devel
parent74d40b011c27dc343ad56022a322d212135c96ed (diff)
downloadqemu-9ca404f0043d63043bfed3af8da3adedc062cb13.zip
qemu-9ca404f0043d63043bfed3af8da3adedc062cb13.tar.gz
qemu-9ca404f0043d63043bfed3af8da3adedc062cb13.tar.bz2
docs/qapi-domain: add :namespace: override option
Akin to the :module: override option, the :namespace: options allows you to forcibly override the contextual namespace associatied with a definition. We don't necessarily actually need this, but I felt compelled to stick close to how the Python domain works that offers context overrides. As of this commit, it is possible to add e.g. ":namespace: QMP" to any QAPI directive to forcibly associate that definition with a given namespace. Signed-off-by: John Snow <jsnow@redhat.com> Message-ID: <20250313044312.189276-5-jsnow@redhat.com> Acked-by: Markus Armbruster <armbru@redhat.com> Signed-off-by: Markus Armbruster <armbru@redhat.com>
Diffstat (limited to 'docs/devel')
-rw-r--r--docs/devel/qapi-domain.rst2
1 files changed, 2 insertions, 0 deletions
diff --git a/docs/devel/qapi-domain.rst b/docs/devel/qapi-domain.rst
index 1475870..51b2832 100644
--- a/docs/devel/qapi-domain.rst
+++ b/docs/devel/qapi-domain.rst
@@ -466,6 +466,8 @@ QAPI standard options
All QAPI directives -- *except* for module -- support these common options.
+* ``:namespace: name`` -- This option allows you to override the
+ namespace association of a given definition.
* ``:module: modname`` -- Borrowed from the Python domain, this option allows
you to override the module association of a given definition.
* ``:since: x.y`` -- Allows the documenting of "Since" information, which is