Re: [libvirt] [libvirt-glib 5/5] Add gvir_config_domain_os_get_boot_devices()
On Fri, May 11, 2012 at 01:32:34PM +0100, Daniel P. Berrange wrote:
If I look at the docs for GTK, I see GTK-DOC is including details of
the annotations:
eg
http://developer.gnome.org/gtk3/stable/GtkWindow.html#gtk-window-get-defa...
"Returns: copy of default icon list. [element-type GdkPixbuf][transfer
container]"
IMHO this is sufficient and we don't need to explicitly mention the
transfer rules in the docs string.
I know it's in there, but if you are not familiar with gtk conventions at
all, you have to first figure out what that means exactly, and then you
have to find the correct way of free-ing the container and what it contains
(which is not necessarily g_object_unref, it can contain strings, boxed
types, ...). That's why I really prefer having it mentioned explicitly,
memory handling is boring enough/error-prone enough so anything that makes
it simpler is a plus in my opinion.
Christophe
Attachments:
- attachment.sig (application/pgp-signature — 198 bytes)