aboutsummaryrefslogtreecommitdiff
path: root/qapi
diff options
context:
space:
mode:
authorPeter Maydell <peter.maydell@linaro.org>2015-11-17 10:20:25 +0000
committerPeter Maydell <peter.maydell@linaro.org>2015-11-17 10:20:25 +0000
commit361cb26827ffd5f24af05b0e473ecd82d6a33bde (patch)
tree0bd423d2ac99b51f3952a3f79926b0cab69d4185 /qapi
parentc257779e2a586043a1480bb7e96fb6bcd0129634 (diff)
parent513e7cdbaeec56c77e4cf26f151d7ee79f3a6be9 (diff)
Merge remote-tracking branch 'remotes/armbru/tags/pull-qapi-2015-11-17' into staging
QAPI patches # gpg: Signature made Tue 17 Nov 2015 08:28:24 GMT using RSA key ID EB918653 # gpg: Good signature from "Markus Armbruster <armbru@redhat.com>" # gpg: aka "Markus Armbruster <armbru@pond.sub.org>" * remotes/armbru/tags/pull-qapi-2015-11-17: input: Document why x-input-send-event is still experimental qapi: Document introspection stability considerations Signed-off-by: Peter Maydell <peter.maydell@linaro.org>
Diffstat (limited to 'qapi')
-rw-r--r--qapi/introspect.json9
1 files changed, 9 insertions, 0 deletions
diff --git a/qapi/introspect.json b/qapi/introspect.json
index e7c4c3e998..9e9369e160 100644
--- a/qapi/introspect.json
+++ b/qapi/introspect.json
@@ -22,6 +22,15 @@
# what's there), not interface specification. The specification is in
# the QAPI schema.
#
+# Furthermore, while we strive to keep the QMP wire format
+# backwards-compatible across qemu versions, the introspection output
+# is not guaranteed to have the same stability. For example, one
+# version of qemu may list an object member as an optional
+# non-variant, while another lists the same member only through the
+# object's variants; or the type of a member may change from a generic
+# string into a specific enum or from one specific type into an
+# alternate that includes the original type alongside something else.
+#
# Returns: array of @SchemaInfo, where each element describes an
# entity in the ABI: command, event, type, ...
#