pidgin3: comparison libpurple/request.h

-:00f876b129bc
+:38facb8226d4
 /**
 * Returns a list of all groups in a field list.
 *
 * @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);
 /**
 * Set tab names for a field list.
 /**
 * Returns a list of all required fields.
 *
 * @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);
 /**
 * Returns a list of all validated fields.
 *
 * @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);
 /**
 * Returns a list of all fields with sensitivity callback added.
 *
 * @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);
 /**
 /**
 * Returns a list of all fields in a group.
 *
 * @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);
 /**
 * Returns a list of all fields in a group.
 *
 * @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);
 /*@}*/
 /**
 * Returns a list of elements in a choice field.
 *
 * @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);
 /**
 * To retrieve the data for each item, use
 * purple_request_field_list_get_data().
 *
 * @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);
 /**
 * Returns a list of items in a list field.
 *
 * @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);
 /**
 * Returns a list of icons in a list field.
 *
 * The icons will correspond with the items, in order.
 *
 * @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);
 /*@}*/
 /**
 * Returns a datasheet for a field.
 *
 * @field: The field.
 *
-* Returns: (TODO const): The datasheet object.
+* Returns: (transfer none): The datasheet object.
 */
 PurpleRequestDatasheet *purple_request_field_datasheet_get_sheet(
 	PurpleRequestField *field);
 /*@}*/

Mercurial > pidgin3 / file comparison

comparison: libpurple/request.h

libpurple/request.h