• E
    virobject: Improve documentation · 632ac8f8
    Eric Blake 提交于
    I had to inspect the code to learn whether a final virObjectUnref()
    calls ALL dispose callbacks in child-to-parent order (akin to C++
    destructors), or whether I manually had to call a parent-class dispose
    when writing a child class dispose method.  The answer is the
    former. (Thankfully, since VIR_FREE wipes out pointers for safety,
    even if I had guessed wrong, I probably would not have tripped over a
    double-free fault when the parent dispose ran for the second time).  I
    also had to read the code to learn if a dispose method was even
    mandatory (it is not, although getting NULL through VIR_CLASS_NEW
    requires a macro).  While at it, the VIR_CLASS_NEW macro requires that
    the virObject component at offset 0 be reached through the name
    'parent', not 'object'.
    Signed-off-by: NEric Blake <eblake@redhat.com>
    Reviewed-by: NErik Skultety <eskultet@redhat.com>
    632ac8f8
virobject.h 4.0 KB