Mercurial > pidgin3 / file diff

--- a/pidgin/gtkblist.h	Thu Oct 12 21:37:01 2017 -0500
+++ b/pidgin/gtkblist.h	Tue Oct 17 21:10:31 2017 -0500
@@ -241,7 +241,7 @@
  * This may be an existing pixbuf that has been given an additional ref,
  * so it shouldn't be modified.
  *
- * Returns:  A GdkPixbuf for the emblem to show, or NULL
+ * Returns: (transfer full): A GdkPixbuf for the emblem to show, or NULL
  */
 GdkPixbuf *
 pidgin_blist_get_emblem(PurpleBlistNode *node);
@@ -250,6 +250,8 @@
  * pidgin_blist_get_status_icon:
  *
  * Useful for the buddy ticker
+ *
+ * Returns: (transfer full): A #GdkPixbuf of status icon.
  */
 GdkPixbuf *pidgin_blist_get_status_icon(PurpleBlistNode *node,
 		PidginStatusIconSize size);
@@ -317,7 +319,7 @@
  *
  * Gets Pidgin's current buddy list theme
  *
- * Returns:	the current theme
+ * Returns:	(transfer none): the current theme
  */
 PidginBlistTheme *pidgin_blist_get_theme(void);
 
@@ -332,7 +334,7 @@
  *
  * Gets the current list of sort methods.
  *
- * Returns: A GSlist of sort methods
+ * Returns: (transfer none) (element-type PidginBlistSortMethod): A GSlist of sort methods
  */
 GList *pidgin_blist_get_sort_methods(void);
 
@@ -348,7 +350,7 @@
  * pidgin_blist_sort_method_reg:
  * @id:   The unique ID of the sorting method
  * @name: The method's name.
- * @func:  A pointer to the function.
+ * @func: (scope call): A pointer to the function.
  *
  * Registers a buddy list sorting method.
  */