Re: GDataInputStream API return types

On 2012-11-28 12:38, Henrique Camargo <henrique henriquecamargo com> wrote:
On Wed, Nov 28, 2012 at 11:56 AM, David King <amigadave amigadave com> wrote:
The "transfer full" annotation is given on the return type, and the title
text is "free data after the code is done".

I have imagined that the annotation could mean that the data should be
freed but I didn't notice the title text at the time.

OK. I admit that it took me a little while to realise about the title text too.

I think that the annotation alone is not clear, the title text makes
it clear though. IMHO the stylesheet for the gtk-doc generated html
used at should make the presence of the
title text more obvious. The stylesheet used for the gstreamer
documentation is a little better in this aspect [1].


It is possible to view the GTK+ documentation with the same CSS (which is the default gtk-doc style, I think) by installing the relevant documentation package locally and then either using Devhelp (a really useful tool, by the way) or opening the files with a browser. They should be located at:


where gtk3 can be replaced with any other package for which you have documentation.

To improve the CSS, I would suggest filing a bug:

against the component. It should be quite easy to fix. The CSS files can be found in the library-web module:

Please post back on the list when you file the bug, and I (or one of the library-web maintainers) can look into it.


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