The ownership rules of some QOM and qdev functions are not very
clear.  Some of the rules are not trivial because they depend
on other arguments or flags specified when a property was
created.

This is an attempt to clarify the existing ownership rules of
those functions to avoid confusion in the future.

Eduardo Habkost (3):
  qom: Document reference count ownership rules
  qdev: Document ownership rules of qbus_create*()
  pci: Document ownership rules of pci_root_bus_new*()

 include/hw/pci/pci.h   | 15 +++++++++
 include/hw/qdev-core.h | 24 ++++++++++++++
 include/qom/object.h   | 73 ++++++++++++++++++++++++------------------
 hw/core/bus.c          |  5 +++
 4 files changed, 86 insertions(+), 31 deletions(-)

-- 
2.18.0.rc1.1.g3f1ff2140