/soc/2013/ankitkv/gobjectification: 38facb8226d4: Use 'transfer ...

Ankit Vani a at nevitus.org
Fri Jan 31 08:17:04 EST 2014


Changeset: 38facb8226d4a4cb49f068d32b08021898bc3be4
Author:	 Ankit Vani <a at nevitus.org>
Date:	 2014-01-31 18:44 +0530
Branch:	 gtkdoc-conversion
URL: https://hg.pidgin.im/soc/2013/ankitkv/gobjectification/rev/38facb8226d4

Description:

Use 'transfer none' for TODO const

diffstat:

 libpurple/account.h           |   8 ++++----
 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              |  10 +++++-----
 libpurple/notify.h            |   2 +-
 libpurple/plugin.h            |   8 ++++----
 libpurple/pluginpref.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 +-
 20 files changed, 48 insertions(+), 48 deletions(-)

diffs (truncated from 474 to 300 lines):

diff --git a/libpurple/account.h b/libpurple/account.h
--- a/libpurple/account.h
+++ b/libpurple/account.h
@@ -858,7 +858,7 @@ void purple_account_privacy_deny(PurpleA
  * Returns the account's permit list.
  *
  * @account:	The account.
- * Returns: (TODO const):     A list of the permitted users
+ * Returns: (transfer none):     A list of the permitted users
  */
 GSList *purple_account_privacy_get_permitted(PurpleAccount *account);
 
@@ -866,7 +866,7 @@ GSList *purple_account_privacy_get_permi
  * Returns the account's deny list.
  *
  * @account:	The account.
- * Returns: (TODO const):     A list of the denied users
+ * Returns: (transfer none):     A list of the denied users
  */
 GSList *purple_account_privacy_get_denied(PurpleAccount *account);
 
@@ -959,7 +959,7 @@ gboolean purple_account_is_status_active
  *
  * @account: The account.
  *
- * Returns: (TODO const): The account's status types.
+ * Returns: (transfer none): The account's status types.
  */
 GList *purple_account_get_status_types(const PurpleAccount *account);
 
@@ -1136,7 +1136,7 @@ gboolean purple_account_supports_offline
  * account is happily connected or disconnected without an error.
  *
  * @account: The account whose error should be retrieved.
- * Returns: (TODO const):   The type of error and a human-readable description of the
+ * Returns: (transfer none):   The type of error and a human-readable description of the
  *                current error, or %NULL if there is no current error.  This
  *                pointer is guaranteed to remain valid until the @ref
  *                account-error-changed signal is emitted for @a account.
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
@@ -56,21 +56,21 @@ void purple_conversations_remove(PurpleC
  *
  * 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,8 +87,8 @@ void purple_mime_document_write(PurpleMi
  *
  * @doc: The MIME document.
  *
- * Returns: (TODO const): A list of strings indicating the fields (but not the values
- *              of the fields) in the header of doc.
+ * 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,8 +139,8 @@ PurpleMimePart *purple_mime_part_new(Pur
  *
  * @part: The MIME document part.
  *
- * Returns: (TODO const): List of strings indicating the fields (but not the values
- *              of the fields) in the header of part.
+ * 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/plugin.h b/libpurple/plugin.h
--- a/libpurple/plugin.h
+++ b/libpurple/plugin.h
@@ -518,7 +518,7 @@ void purple_plugins_add_search_path(cons
 /**
  * Returns a list of plugin search paths.
  *
- * Returns: (TODO const): A list of searched paths.
+ * Returns: (transfer none): A list of searched paths.
  */
 GList *purple_plugins_get_search_paths(void);
 
@@ -607,7 +607,7 @@ PurplePlugin *purple_plugins_find_with_i
 /**
  * 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);
 
@@ -617,14 +617,14 @@ GList *purple_plugins_get_loaded(void);
  * to the PURPLE_INIT_PLUGIN() macro, or if it was compiled
  * against an incompatable API version.
  *
- * Returns: (TODO const): A list of all protocol plugins.
+ * Returns: (transfer none): A list of all protocol plugins.
  */
 GList *purple_plugins_get_protocols(void);
 
 /**
  * Returns a list of all plugins, whether loaded or not.
  *
- * Returns: (TODO const): A list of all plugins.
+ * Returns: (transfer none): A list of all plugins.
  */
 GList *purple_plugins_get_all(void);
 
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/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.



More information about the Commits mailing list