This patch demonstrates what happens when you mess up a field list
entry. The next patch adds a safeguard against this.
Signed-off-by: John Snow <jsnow@redhat.com>
---
docs/qapi/index.rst | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/docs/qapi/index.rst b/docs/qapi/index.rst
index c68e2044890..5bb1c37a5ed 100644
--- a/docs/qapi/index.rst
+++ b/docs/qapi/index.rst
@@ -129,6 +129,10 @@ Explicit cross-referencing syntax for QAPI modules is available with
argument values. It's very temperamental.
:return SomeTypeName: An esoteric collection of mystical nonsense to
both confound and delight.
+ :arg: this is malformed.
+ :memb: this is malformed and unrecognized.
+ :choice type name: This is unrecognized.
+ :errors FooError: Also malformed.
Field lists can appear anywhere in the directive block, but any field
list entries in the same list block that are recognized as special
--
2.44.0