Re: [Qemu-devel] [PATCH v3 12/12] qom: remove object_delete

[Paolo Bonzini]

Il 25/01/2013 12:56, Andreas Färber ha scritto:
>> > - * This function will initialize a new object using heap allocated 
>> > memory.  This
>> > - * function should be paired with object_delete() to free the resources
>> > - * associated with the object.
>> > + * This function will initialize a new object using heap allocated memory.
>> >   *
>> >   * Returns: The newly allocated and instantiated object.
>> >   */
> [snip]
> 
> Why not just update object_delete() -> object_unref() within the
> documentation comment? At least somewhere we should prominently document
> how these functions are to be used together.

I can include in the comment that the returned object has 1 reference.

Paolo