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
