/soc/2013/ankitkv/gobjectification: d891503c8aa6: Use 'transfer ...

Ankit Vani a at nevitus.org
Tue Jan 28 23:40:37 EST 2014


Changeset: d891503c8aa62fcd12788b4b81ecb94f9bb3332b
Author:	 Ankit Vani <a at nevitus.org>
Date:	 2014-01-29 10:10 +0530
Branch:	 soc.2013.gobjectification.plugins
URL: https://hg.pidgin.im/soc/2013/ankitkv/gobjectification/rev/d891503c8aa6

Description:

Use 'transfer none' annotation for @constreturn lists

diffstat:

 libpurple/accountopt.h        |   4 ++--
 libpurple/accounts.h          |   2 +-
 libpurple/blistnodetypes.h    |   2 +-
 libpurple/connection.h        |   4 ++--
 libpurple/conversations.h     |   6 +++---
 libpurple/conversationtypes.h |   4 ++--
 libpurple/mime.h              |   6 +++---
 libpurple/notify.h            |   2 +-
 libpurple/pluginpref.h        |   4 ++--
 libpurple/plugins.h           |   4 ++--
 libpurple/pounce.h            |   2 +-
 libpurple/presence.h          |   2 +-
 libpurple/request-datasheet.h |   4 ++--
 libpurple/request.h           |  22 +++++++++++-----------
 libpurple/roomlist.h          |   4 ++--
 libpurple/savedstatuses.h     |   2 +-
 libpurple/status.h            |   2 +-
 libpurple/util.h              |   2 +-
 pidgin/gtksmiley.h            |   2 +-
 19 files changed, 40 insertions(+), 40 deletions(-)

diffs (truncated from 414 to 300 lines):

diff --git a/libpurple/accountopt.h b/libpurple/accountopt.h
--- a/libpurple/accountopt.h
+++ b/libpurple/accountopt.h
@@ -280,7 +280,7 @@ purple_account_option_string_get_masked(
  *
  * @option: The account option.
  *
- * Returns: (TODO const): A list of hints, stored as strings.
+ * Returns: (transfer none): A list of hints, stored as strings.
  */
 const GSList * purple_account_option_string_get_hints(const PurpleAccountOption *option);
 
@@ -289,7 +289,7 @@ const GSList * purple_account_option_str
  *
  * @option: The account option.
  *
- * Returns: (TODO const): A list of #PurpleKeyValuePair, mapping the human-readable
+ * Returns: (transfer none): A list of #PurpleKeyValuePair, mapping the human-readable
  *              description of the value to the <tt>(const char *)</tt> that
  *              should be passed to purple_account_set_string() to set the
  *              option.
diff --git a/libpurple/accounts.h b/libpurple/accounts.h
--- a/libpurple/accounts.h
+++ b/libpurple/accounts.h
@@ -134,7 +134,7 @@ void purple_accounts_reorder(PurpleAccou
 /**
  * Returns a list of all accounts.
  *
- * Returns: (TODO const): A list of all accounts.
+ * Returns: (transfer none): A list of all accounts.
  */
 GList *purple_accounts_get_all(void);
 
diff --git a/libpurple/blistnodetypes.h b/libpurple/blistnodetypes.h
--- a/libpurple/blistnodetypes.h
+++ b/libpurple/blistnodetypes.h
@@ -540,7 +540,7 @@ PurpleAccount *purple_chat_get_account(P
  *
  * @chat:  The chat.
  *
- * Returns: (TODO const):  The hashtable.
+ * Returns: (transfer none):  The hashtable.
  */
 GHashTable *purple_chat_get_components(PurpleChat *chat);
 
diff --git a/libpurple/connection.h b/libpurple/connection.h
--- a/libpurple/connection.h
+++ b/libpurple/connection.h
@@ -484,14 +484,14 @@ void purple_connections_disconnect_all(v
  * Returns a list of all active connections.  This does not
  * include connections that are in the process of connecting.
  *
- * Returns: (TODO const): A list of all active connections.
+ * Returns: (transfer none): A list of all active connections.
  */
 GList *purple_connections_get_all(void);
 
 /**
  * Returns a list of all connections in the process of connecting.
  *
- * Returns: (TODO const): A list of connecting connections.
+ * Returns: (transfer none): A list of connecting connections.
  */
 GList *purple_connections_get_connecting(void);
 
diff --git a/libpurple/conversations.h b/libpurple/conversations.h
--- a/libpurple/conversations.h
+++ b/libpurple/conversations.h
@@ -68,21 +68,21 @@ void purple_conversations_update_cache(P
  *
  * This list includes both IMs and chats.
  *
- * Returns: (TODO const): A GList of all conversations.
+ * Returns: (transfer none): A GList of all conversations.
  */
 GList *purple_conversations_get_all(void);
 
 /**
  * Returns a list of all IMs.
  *
- * Returns: (TODO const): A GList of all IMs.
+ * Returns: (transfer none): A GList of all IMs.
  */
 GList *purple_conversations_get_ims(void);
 
 /**
  * Returns a list of all chats.
  *
- * Returns: (TODO const): A GList of all chats.
+ * Returns: (transfer none): A GList of all chats.
  */
 GList *purple_conversations_get_chats(void);
 
diff --git a/libpurple/conversationtypes.h b/libpurple/conversationtypes.h
--- a/libpurple/conversationtypes.h
+++ b/libpurple/conversationtypes.h
@@ -330,7 +330,7 @@ PurpleChatConversation *purple_chat_conv
  *
  * @chat: The chat.
  *
- * Returns: (TODO const): The list of users.
+ * Returns: (transfer none): The list of users.
  */
 GList *purple_chat_conversation_get_users(const PurpleChatConversation *chat);
 
@@ -365,7 +365,7 @@ GList *purple_chat_conversation_set_igno
  *
  * @chat: The chat.
  *
- * Returns: (TODO const): The list of ignored users.
+ * Returns: (transfer none): The list of ignored users.
  */
 GList *purple_chat_conversation_get_ignored(const PurpleChatConversation *chat);
 
diff --git a/libpurple/mime.h b/libpurple/mime.h
--- a/libpurple/mime.h
+++ b/libpurple/mime.h
@@ -87,7 +87,7 @@ void purple_mime_document_write(PurpleMi
  *
  * @doc: The MIME document.
  *
- * Returns: (TODO const): A list of strings indicating the fields (but not the values
+ * Returns: (transfer none): A list of strings indicating the fields (but not the values
  *              of the fields) in the header of doc.
  */
 GList *purple_mime_document_get_fields(PurpleMimeDocument *doc);
@@ -122,7 +122,7 @@ void purple_mime_document_set_field(Purp
  *
  * @doc: The MIME document.
  *
- * Returns: (TODO const):   List of PurpleMimePart contained within doc.
+ * Returns: (transfer none):   List of PurpleMimePart contained within doc.
  */
 GList *purple_mime_document_get_parts(PurpleMimeDocument *doc);
 
@@ -139,7 +139,7 @@ PurpleMimePart *purple_mime_part_new(Pur
  *
  * @part: The MIME document part.
  *
- * Returns: (TODO const): List of strings indicating the fields (but not the values
+ * Returns: (transfer none): List of strings indicating the fields (but not the values
  *              of the fields) in the header of part.
  */
 GList *purple_mime_part_get_fields(PurpleMimePart *part);
diff --git a/libpurple/notify.h b/libpurple/notify.h
--- a/libpurple/notify.h
+++ b/libpurple/notify.h
@@ -464,7 +464,7 @@ void purple_notify_user_info_destroy(Pur
  *
  * @user_info:  The PurpleNotifyUserInfo
  *
- * Returns: (TODO const): A GQueue of PurpleNotifyUserInfoEntry objects.
+ * Returns: (transfer none): A GQueue of PurpleNotifyUserInfoEntry objects.
  */
 GQueue *purple_notify_user_info_get_entries(PurpleNotifyUserInfo *user_info);
 
diff --git a/libpurple/pluginpref.h b/libpurple/pluginpref.h
--- a/libpurple/pluginpref.h
+++ b/libpurple/pluginpref.h
@@ -83,7 +83,7 @@ void purple_plugin_pref_frame_add(Purple
  * Get the plugin preferences from a plugin preference frame
  *
  * @frame: The plugin frame to get the plugin preferences from
- * Returns: (TODO const): a GList of plugin preferences
+ * Returns: (transfer none): a GList of plugin preferences
  */
 GList *purple_plugin_pref_frame_get_prefs(PurplePluginPrefFrame *frame);
 
@@ -205,7 +205,7 @@ void purple_plugin_pref_add_choice(Purpl
  * Get the choices for a choices plugin pref
  *
  * @pref: The plugin pref
- * Returns: (TODO const): GList of the choices
+ * Returns: (transfer none): GList of the choices
  */
 GList *purple_plugin_pref_get_choices(PurplePluginPref *pref);
 
diff --git a/libpurple/plugins.h b/libpurple/plugins.h
--- a/libpurple/plugins.h
+++ b/libpurple/plugins.h
@@ -485,7 +485,7 @@ gboolean purple_plugin_is_internal(const
  *
  * @plugin: The plugin whose dependent plugins are returned.
  *
- * Returns: (TODO const): The list of a plugins that depend on the specified plugin.
+ * Returns: (transfer none): The list of a plugins that depend on the specified plugin.
  */
 GSList *purple_plugin_get_dependent_plugins(const PurplePlugin *plugin);
 
@@ -810,7 +810,7 @@ GList *purple_plugins_find_all(void);
 /**
  * Returns a list of all loaded plugins.
  *
- * Returns: (TODO const): A list of all loaded plugins.
+ * Returns: (transfer none): A list of all loaded plugins.
  */
 GList *purple_plugins_get_loaded(void);
 
diff --git a/libpurple/pounce.h b/libpurple/pounce.h
--- a/libpurple/pounce.h
+++ b/libpurple/pounce.h
@@ -311,7 +311,7 @@ void purple_pounces_unregister_handler(c
 /**
  * Returns a list of all registered buddy pounces.
  *
- * Returns: (TODO const): The list of buddy pounces.
+ * Returns: (transfer none): The list of buddy pounces.
  */
 GList *purple_pounces_get_all(void);
 
diff --git a/libpurple/presence.h b/libpurple/presence.h
--- a/libpurple/presence.h
+++ b/libpurple/presence.h
@@ -277,7 +277,7 @@ void purple_presence_set_login_time(Purp
  *
  * @presence: The presence.
  *
- * Returns: (TODO const): The statuses.
+ * Returns: (transfer none): The statuses.
  */
 GList *purple_presence_get_statuses(const PurplePresence *presence);
 
diff --git a/libpurple/request-datasheet.h b/libpurple/request-datasheet.h
--- a/libpurple/request-datasheet.h
+++ b/libpurple/request-datasheet.h
@@ -120,7 +120,7 @@ purple_request_datasheet_get_column_titl
  *
  * @sheet: The datasheet.
  *
- * Returns: (TODO const): The list of records.
+ * Returns: (transfer none): The list of records.
  */
 const GList *
 purple_request_datasheet_get_records(PurpleRequestDatasheet *sheet);
@@ -142,7 +142,7 @@ purple_request_datasheet_add_action(Purp
  *
  * @sheet: The datasheet.
  *
- * Returns: (TODO const): The list of actions.
+ * Returns: (transfer none): The list of actions.
  */
 const GList *
 purple_request_datasheet_get_actions(PurpleRequestDatasheet *sheet);
diff --git a/libpurple/request.h b/libpurple/request.h
--- a/libpurple/request.h
+++ b/libpurple/request.h
@@ -485,7 +485,7 @@ void purple_request_fields_add_group(Pur
  *
  * @fields: The fields list.
  *
- * Returns: (TODO const): A list of groups.
+ * Returns: (transfer none): A list of groups.
  */
 GList *purple_request_fields_get_groups(const PurpleRequestFields *fields);
 
@@ -526,7 +526,7 @@ gboolean purple_request_fields_exists(co
  *
  * @fields: The fields list.
  *
- * Returns: (TODO const): The list of required fields.
+ * Returns: (transfer none): The list of required fields.
  */
 const GList *purple_request_fields_get_required(
 	const PurpleRequestFields *fields);
@@ -536,7 +536,7 @@ const GList *purple_request_fields_get_r
  *
  * @fields: The fields list.
  *
- * Returns: (TODO const): The list of validated fields.
+ * Returns: (transfer none): The list of validated fields.
  */
 const GList *purple_request_fields_get_validatable(
 	const PurpleRequestFields *fields);
@@ -546,7 +546,7 @@ const GList *purple_request_fields_get_v
  *
  * @fields: The fields list.
  *
- * Returns: (TODO const): The list of fields with automatic sensitivity callback.
+ * Returns: (transfer none): The list of fields with automatic sensitivity callback.
  */
 const GList *
 purple_request_fields_get_autosensitive(const PurpleRequestFields *fields);
@@ -736,7 +736,7 @@ const char *purple_request_field_group_g
  *
  * @group: The group.
  *
- * Returns: (TODO const): The list of fields in the group.
+ * Returns: (transfer none): The list of fields in the group.
  */
 GList *purple_request_field_group_get_fields(
 		const PurpleRequestFieldGroup *group);
@@ -746,7 +746,7 @@ GList *purple_request_field_group_get_fi
  *
  * @group: The group.
  *
- * Returns: (TODO const): The list of fields in the group.
+ * Returns: (transfer none): The list of fields in the group.
  */
 PurpleRequestFields *purple_request_field_group_get_fields_list(
 		const PurpleRequestFieldGroup *group);



More information about the Commits mailing list