Re: GDataInputStream API return types

[David King <amigadave amigadave com>]

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.

--
http://amigadave.com/