[libvirt] [libvirt-glib 5/5] Add gvir_config_domain_os_get_boot_devices()

[Christophe Fergeau]

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-default-icon-list
> 
>   "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
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 198 bytes
Desc: not available
URL: <http://listman.redhat.com/archives/libvir-list/attachments/20120511/b0ad9d64/attachment-0001.sig>