Mercurial > pidgin3 / changeset

--- a/libpurple/protocols/facebook/api.h	Sun Mar 13 22:05:59 2022 -0500
+++ b/libpurple/protocols/facebook/api.h	Sun Mar 13 22:06:00 2022 -0500
@@ -711,7 +711,7 @@
 /**
  * fb_api_thread_create:
  * @api: The #FbApi.
- * @uids: The #GSList of #FbId's.
+ * @uids: (element-type FbId): The #GSList of #FbId's.
  *
  * Sends a thread creation request. In order to create a thread, there
  * must be at least two other users in @uids.

--- a/libpurple/protocols/facebook/data.h	Sun Mar 13 22:05:59 2022 -0500
+++ b/libpurple/protocols/facebook/data.h	Sun Mar 13 22:06:00 2022 -0500
@@ -213,9 +213,10 @@
  * @uid: The user #FbId.
  *
  * Gets a #GSList of messages by the user #FbId from the #FbData. The
- * #FbApiMessage's are removed from the #FbData. The returned #GSList
- * and its #FbApiMessage's should be freed with #fb_api_message_free()
- * and #g_slist_free_full() when no longer needed.
+ * #FbApiMessage's are removed from the #FbData.
+ *
+ * Returns: (element-type FbApiMessage) (transfer full): The messages from the
+ *          user.
  */
 GSList *
 fb_data_take_messages(FbData *fata, FbId uid);

--- a/libpurple/protocols/facebook/util.h	Sun Mar 13 22:05:59 2022 -0500
+++ b/libpurple/protocols/facebook/util.h	Sun Mar 13 22:06:00 2022 -0500
@@ -230,7 +230,7 @@
  * @title: The title of the message or #NULL.
  * @primary: The main point of the message or #NULL.
  * @secondary: The secondary information or #NULL.
- * @select: A #GSList of selected buddies or #NULL.
+ * @select: (element-type PurpleBuddy): A #GSList of selected buddies or #NULL.
  * @multi: #TRUE to for multiple buddy selections, otherwise #FALSE.
  * @ok_cb: The callback for the `OK` button or #NULL.
  * @cancel_cb: The callback for the `Cancel` button or #NULL.