Mercurial > pidgin3 / changeset

--- a/libpurple/accountopt.h	Wed Jan 29 10:01:14 2014 +0530
+++ b/libpurple/accountopt.h	Wed Jan 29 10:10:12 2014 +0530
@@ -280,7 +280,7 @@
  *
  * @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 @@
  *
  * @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.

--- a/libpurple/accounts.h	Wed Jan 29 10:01:14 2014 +0530
+++ b/libpurple/accounts.h	Wed Jan 29 10:10:12 2014 +0530
@@ -134,7 +134,7 @@
 /**
  * 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);
 

--- a/libpurple/blistnodetypes.h	Wed Jan 29 10:01:14 2014 +0530
+++ b/libpurple/blistnodetypes.h	Wed Jan 29 10:10:12 2014 +0530
@@ -540,7 +540,7 @@
  *
  * @chat:  The chat.
  *
- * Returns: (TODO const):  The hashtable.
+ * Returns: (transfer none):  The hashtable.
  */
 GHashTable *purple_chat_get_components(PurpleChat *chat);
 

--- a/libpurple/connection.h	Wed Jan 29 10:01:14 2014 +0530
+++ b/libpurple/connection.h	Wed Jan 29 10:10:12 2014 +0530
@@ -484,14 +484,14 @@
  * 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);
 

--- a/libpurple/conversations.h	Wed Jan 29 10:01:14 2014 +0530
+++ b/libpurple/conversations.h	Wed Jan 29 10:10:12 2014 +0530
@@ -68,21 +68,21 @@
  *
  * 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);
 

--- a/libpurple/conversationtypes.h	Wed Jan 29 10:01:14 2014 +0530
+++ b/libpurple/conversationtypes.h	Wed Jan 29 10:10:12 2014 +0530
@@ -330,7 +330,7 @@
  *
  * @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 @@
  *
  * @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);
 

--- a/libpurple/mime.h	Wed Jan 29 10:01:14 2014 +0530
+++ b/libpurple/mime.h	Wed Jan 29 10:10:12 2014 +0530
@@ -87,7 +87,7 @@
  *
  * @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 @@
  *
  * @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 @@
  *
  * @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);

--- a/libpurple/notify.h	Wed Jan 29 10:01:14 2014 +0530
+++ b/libpurple/notify.h	Wed Jan 29 10:10:12 2014 +0530
@@ -464,7 +464,7 @@
  *
  * @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);
 

--- a/libpurple/pluginpref.h	Wed Jan 29 10:01:14 2014 +0530
+++ b/libpurple/pluginpref.h	Wed Jan 29 10:10:12 2014 +0530
@@ -83,7 +83,7 @@
  * 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 @@
  * 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);
 

--- a/libpurple/plugins.h	Wed Jan 29 10:01:14 2014 +0530
+++ b/libpurple/plugins.h	Wed Jan 29 10:10:12 2014 +0530
@@ -485,7 +485,7 @@
  *
  * @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 @@
 /**
  * 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);
 

--- a/libpurple/pounce.h	Wed Jan 29 10:01:14 2014 +0530
+++ b/libpurple/pounce.h	Wed Jan 29 10:10:12 2014 +0530
@@ -311,7 +311,7 @@
 /**
  * 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);
 

--- a/libpurple/presence.h	Wed Jan 29 10:01:14 2014 +0530
+++ b/libpurple/presence.h	Wed Jan 29 10:10:12 2014 +0530
@@ -277,7 +277,7 @@
  *
  * @presence: The presence.
  *
- * Returns: (TODO const): The statuses.
+ * Returns: (transfer none): The statuses.
  */
 GList *purple_presence_get_statuses(const PurplePresence *presence);
 

--- a/libpurple/request-datasheet.h	Wed Jan 29 10:01:14 2014 +0530
+++ b/libpurple/request-datasheet.h	Wed Jan 29 10:10:12 2014 +0530
@@ -120,7 +120,7 @@
  *
  * @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 @@
  *
  * @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);

--- a/libpurple/request.h	Wed Jan 29 10:01:14 2014 +0530
+++ b/libpurple/request.h	Wed Jan 29 10:10:12 2014 +0530
@@ -485,7 +485,7 @@
  *
  * @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 @@
  *
  * @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 @@
  *
  * @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 @@
  *
  * @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 @@
  *
  * @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 @@
  *
  * @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);
@@ -1304,7 +1304,7 @@
  *
  * @field: The field.
  *
- * Returns: (TODO const): The list of pairs <label, value>.
+ * Returns: (transfer none): The list of pairs <label, value>.
  */
 GList *
 purple_request_field_choice_get_elements(const PurpleRequestField *field);
@@ -1422,7 +1422,7 @@
  *
  * @field: The field.
  *
- * Returns: (TODO const): The list of selected items.
+ * Returns: (transfer none): The list of selected items.
  */
 GList *purple_request_field_list_get_selected(
 	const PurpleRequestField *field);
@@ -1432,7 +1432,7 @@
  *
  * @field: The field.
  *
- * Returns: (TODO const): The list of items.
+ * Returns: (transfer none): The list of items.
  */
 GList *purple_request_field_list_get_items(const PurpleRequestField *field);
 
@@ -1443,7 +1443,7 @@
  *
  * @field: The field.
  *
- * Returns: (TODO const): The list of icons or %NULL (i.e. the empty GList) if no
+ * Returns: (transfer none): The list of icons or %NULL (i.e. the empty GList) if no
  *              items have icons.
  */
 GList *purple_request_field_list_get_icons(const PurpleRequestField *field);
@@ -1694,7 +1694,7 @@
  *
  * @field: The field.
  *
- * Returns: (TODO const): The datasheet object.
+ * Returns: (transfer none): The datasheet object.
  */
 PurpleRequestDatasheet *purple_request_field_datasheet_get_sheet(
 	PurpleRequestField *field);

--- a/libpurple/roomlist.h	Wed Jan 29 10:01:14 2014 +0530
+++ b/libpurple/roomlist.h	Wed Jan 29 10:10:12 2014 +0530
@@ -240,7 +240,7 @@
  * Get the list of fields for a roomlist.
  *
  * @roomlist: The roomlist, which must not be %NULL.
- * Returns: (TODO const): A list of fields
+ * Returns: (transfer none): A list of fields
  */
 GList *purple_roomlist_get_fields(PurpleRoomlist *roomlist);
 
@@ -365,7 +365,7 @@
  * Get the list of fields for a room.
  *
  * @room:  The room, which must not be %NULL.
- * Returns: (TODO const): A list of fields
+ * Returns: (transfer none): A list of fields
  */
 GList * purple_roomlist_room_get_fields(PurpleRoomlistRoom *room);
 

--- a/libpurple/savedstatuses.h	Wed Jan 29 10:01:14 2014 +0530
+++ b/libpurple/savedstatuses.h	Wed Jan 29 10:10:12 2014 +0530
@@ -169,7 +169,7 @@
 /**
  * Returns all saved statuses.
  *
- * Returns: (TODO const): A list of saved statuses.
+ * Returns: (transfer none): A list of saved statuses.
  */
 GList *purple_savedstatuses_get_all(void);
 

--- a/libpurple/status.h	Wed Jan 29 10:01:14 2014 +0530
+++ b/libpurple/status.h	Wed Jan 29 10:10:12 2014 +0530
@@ -370,7 +370,7 @@
  *
  * @status_type: The status type.
  *
- * Returns: (TODO const): The list of attributes.
+ * Returns: (transfer none): The list of attributes.
  */
 GList *purple_status_type_get_attrs(const PurpleStatusType *status_type);
 

--- a/libpurple/util.h	Wed Jan 29 10:01:14 2014 +0530
+++ b/libpurple/util.h	Wed Jan 29 10:10:12 2014 +0530
@@ -1439,7 +1439,7 @@
  * Gets the host name of the machine. If it not possible to determine the
  * host name, "localhost" is returned
  *
- * Returns: (TODO const): The hostname
+ * Returns: The hostname
  */
 const gchar *purple_get_host_name(void);
 

--- a/pidgin/gtksmiley.h	Wed Jan 29 10:01:14 2014 +0530
+++ b/pidgin/gtksmiley.h	Wed Jan 29 10:10:12 2014 +0530
@@ -61,7 +61,7 @@
 /**
  * Returns a GSList with the GtkIMHtmlSmiley of each custom smiley
  *
- * Returns: (TODO const): A GtkIMHmlSmiley list
+ * Returns: (transfer none): A GtkIMHmlSmiley list
  */
 GSList *pidgin_smileys_get_all(void);