[Qemu-devel] [PATCH v2 01/26] sysbus: document SysBusDeviceClass about @init

[Hu Tao <hutao@cn.fujitsu.com>]

Signed-off-by: Hu Tao <hutao@cn.fujitsu.com>
---
 include/hw/sysbus.h | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/include/hw/sysbus.h b/include/hw/sysbus.h
index 7c2e316..9614758 100644
--- a/include/hw/sysbus.h
+++ b/include/hw/sysbus.h
@@ -23,6 +23,16 @@ typedef struct SysBusDevice SysBusDevice;
 #define SYS_BUS_DEVICE_GET_CLASS(obj) \
      OBJECT_GET_CLASS(SysBusDeviceClass, (obj), TYPE_SYS_BUS_DEVICE)
 
+/*
+ * SysBusDeviceClass:
+ * @parent_class: This is private
+ * @init: Callback function invoked when the #DeviceState::realized property
+ * is changed to %true. Deprecated, new types inheriting directly from
+ * TYPE_SYS_BUS_DEVICE should use #DeviceClass::realize instead, new leaf
+ * types should consult their respective parent type. SysBusDeviceClass is
+ * not implementing #DeviceClass::realize, so deriving classes can simply
+ * ignore it.
+ */
 typedef struct SysBusDeviceClass {
     DeviceClass parent_class;
 
-- 
1.8.3.1