pidgin/pidgin

Add missing element-type annotation in Facebook

2022-03-13, Elliott Sales de Andrade
3f0b065e58f7
Parents bfd8314a1a74
Children 2f1bed3c4738
Add missing element-type annotation in Facebook
--- 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.