> > > 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 _______________________________________________ gtk-app-devel-list mailing list gtk-app-devel-list@gnome.org http://mail.gnome.org/mailman/listinfo/gtk-app-devel-list