Re: GDataInputStream API return types

On 2012-11-28 13:36, Emmanuele Bassi <ebassi gmail com> wrote:
On 28 November 2012 13:29, Henrique Camargo
<henrique henriquecamargo com> wrote:
Maybe it can be improved to
explicitly remind the user that the pointer should be g_free 'd.

... care to file a bug and prepare a documentation patch? those
usually get reviewed and applied really quickly.

The "transfer full" annotation is given on the return type, and the title text is "free data after the code is done".

It would be good to have some guidance on whether the annotation (and the corresponding acronym tag in the documentation) is sufficient, or whether each transfer annotation should also include some explicit warning of what is required from the programmer. I would personally favour just using the annotation, but maybe there are certain cases where being explicit is a significant improvement.


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]