pidgin/pidgin

Add missing return transfer annotation in Facebook

2022-03-13, Elliott Sales de Andrade
bfd8314a1a74
Parents 138cabf96219
Children 3f0b065e58f7
Add missing return transfer annotation in Facebook
--- a/libpurple/protocols/facebook/data.h Sun Mar 13 22:05:59 2022 -0500
+++ b/libpurple/protocols/facebook/data.h Sun Mar 13 22:05:59 2022 -0500
@@ -127,7 +127,7 @@
*
* Gets the #FbApi from the #FbData.
*
- * Return: The #FbApi.
+ * Return: (transfer none): The #FbApi.
*/
FbApi *
fb_data_get_api(FbData *fata);
@@ -138,7 +138,7 @@
*
* Gets the #PurpleConnection from the #FbData.
*
- * Return: The #PurpleConnection.
+ * Return: (transfer none): The #PurpleConnection.
*/
PurpleConnection *
fb_data_get_connection(FbData *fata);
@@ -149,7 +149,7 @@
*
* Gets the #PurpleRoomlist from the #FbData.
*
- * Return: The #PurpleRoomlist.
+ * Return: (transfer none): The #PurpleRoomlist.
*/
PurpleRoomlist *
fb_data_get_roomlist(FbData *fata);
@@ -232,7 +232,7 @@
* from HTTP sources. After calling this, #fb_data_image_queue() should
* be called to queue the fetching process.
*
- * Return: The #FbDataImage.
+ * Return: (transfer none): The #FbDataImage.
*/
FbDataImage *
fb_data_image_add(FbData *fata, const gchar *url, FbDataImageFunc func,
@@ -266,7 +266,7 @@
*
* Gets the #FbData from the #FbDataImage.
*
- * Returns: The #FbData.
+ * Returns: (transfer none): The #FbData.
*/
FbData *
fb_data_image_get_fata(FbDataImage *img);
--- a/libpurple/protocols/facebook/http.h Sun Mar 13 22:05:59 2022 -0500
+++ b/libpurple/protocols/facebook/http.h Sun Mar 13 22:05:59 2022 -0500
@@ -82,7 +82,7 @@
* instead of freeing, the returned #FbHttpParams can be closed with
* #fb_http_params_close().
*
- * Returns: The new #FbHttpParams.
+ * Returns: (transfer full): The new #FbHttpParams.
*/
FbHttpParams *
fb_http_params_new(void);
@@ -98,7 +98,7 @@
* instead of freeing, the returned #FbHttpParams can be closed with
* #fb_http_params_close().
*
- * Returns: The new #FbHttpParams.
+ * Returns: (transfer full): The new #FbHttpParams.
*/
FbHttpParams *
fb_http_params_new_parse(const gchar *data, gboolean isurl);
--- a/libpurple/protocols/facebook/json.h Sun Mar 13 22:05:59 2022 -0500
+++ b/libpurple/protocols/facebook/json.h Sun Mar 13 22:05:59 2022 -0500
@@ -97,7 +97,7 @@
* freeing, the returned #JsonBuilder can be closed with
* #fb_json_bldr_close().
*
- * Returns: The new #JsonBuilder.
+ * Returns: (transfer full): The new #JsonBuilder.
*/
JsonBuilder *
fb_json_bldr_new(JsonNodeType type);
--- a/libpurple/protocols/facebook/util.h Sun Mar 13 22:05:59 2022 -0500
+++ b/libpurple/protocols/facebook/util.h Sun Mar 13 22:05:59 2022 -0500
@@ -99,7 +99,7 @@
*
* Finds a buddy by their name or alias.
*
- * Returns: The #PurpleBuddy if found, otherwise #NULL.
+ * Returns: (transfer none): The #PurpleBuddy if found, otherwise #NULL.
*/
PurpleBuddy *
fb_util_account_find_buddy(PurpleAccount *acct, PurpleChatConversation *chat,
@@ -314,7 +314,7 @@
* Deflates a #GByteArray with zlib. The returned #GByteArray should be
* freed with #g_byte_array_free() when no longer needed.
*
- * Returns: The deflated #GByteArray or #NULL on error.
+ * Returns: (transfer full): The deflated #GByteArray or #NULL on error.
*/
GByteArray *
fb_util_zlib_deflate(const GByteArray *bytes, GError **error);
@@ -327,7 +327,7 @@
* Inflates a #GByteArray with zlib. The returned #GByteArray should be
* freed with #g_byte_array_free() when no longer needed.
*
- * Returns: The inflated #GByteArray or #NULL on error.
+ * Returns: (transfer full): The inflated #GByteArray or #NULL on error.
*/
GByteArray *
fb_util_zlib_inflate(const GByteArray *bytes, GError **error);