Re: gtk_builder_add_from_file error handling

[Gabriele Greco <gabriele greco darts it>]

> The proper handling of GErrors is described in great detail in the
> GError documentation.
>
> I don't think it is reasonable to explain this in the documentation of
> every function that uses GError to report errors as there are almost 80
> of them just in Gtk+ (and over 400 in GLib, and many more elsewhere).
I think, and I'm used to see in almost every framework documentations, that
every time a function allocates something that the API user must free
himself the documentation should explicitly say so. Documentation should be
redundant when it may cause errors the fact it is not.

This is the case of GError and for
instance gtk_ui_manager_add_ui_from_file/string
and gtk_builder_add_from_file/string.

It's not a case that in UI toolkit debates one of the most common criticism
to GTK is the "lack of documentation".

-- 
Bye,
 Gabry