[Qemu-devel] [PATCH qemu] qom: Document qom/device-list-properties implementation specific

[Alexey Kardashevskiy <aik@ozlabs.ru>]

Signed-off-by: Alexey Kardashevskiy <aik@ozlabs.ru>
---
 qapi/misc.json | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/qapi/misc.json b/qapi/misc.json
index 5636f4a..399ec74 100644
--- a/qapi/misc.json
+++ b/qapi/misc.json
@@ -1491,6 +1491,10 @@
 #
 # List properties associated with a device.
 #
+# Note: the handler creates a device object, enumerates properties and destroys
+# the object so it only lists properties defined in DeviceClass::props or
+# created by DeviceClass::init()/TypeInfo::instance_init().
+#
 # @typename: the type name of a device
 #
 # Returns: a list of ObjectPropertyInfo describing a devices properties
@@ -1506,6 +1510,11 @@
 #
 # List properties associated with a QOM object.
 #
+# Note: the handler creates an object, enumerates properties and destroys
+# the object so it only lists properties created in TypeInfo::instance_init().
+# Since the instance_init() callback of the device object adds
+# DeviceClass::props as object properties, they will be listed as well.
+#
 # @typename: the type name of an object
 #
 # Returns: a list of ObjectPropertyInfo describing object properties
-- 
2.11.0