pidgin/pidgin

Merged in default (pull request #613)

23 months ago, Gary Kramlich
c085ee3f4867
Merged in default (pull request #613)

Fix some g-ir-scanner warnings

Approved-by: Gary Kramlich
--- a/libpurple/action.h Tue Nov 12 03:02:55 2019 +0000
+++ b/libpurple/action.h Fri Nov 15 02:23:03 2019 +0000
@@ -67,7 +67,7 @@
/**
* purple_action_menu_new:
* @label: The text label to display for this action.
- * @callback: The function to be called when the action is used on
+ * @callback: (scope notified): The function to be called when the action is used on
* the selected item.
* @data: Additional data to be passed to the callback.
* @children: (element-type PurpleActionMenu) (transfer full): Menu actions to
@@ -75,7 +75,7 @@
*
* Creates a new PurpleActionMenu.
*
- * Returns: The PurpleActionMenu.
+ * Returns: (transfer full): The PurpleActionMenu.
*/
PurpleActionMenu *purple_action_menu_new(const gchar *label, GCallback callback, gpointer data, GList *children);
@@ -103,7 +103,7 @@
*
* Returns the callback of the PurpleActionMenu.
*
- * Returns: The callback function.
+ * Returns: (transfer none): The callback function.
*/
GCallback purple_action_menu_get_callback(const PurpleActionMenu *act);
@@ -139,7 +139,7 @@
/**
* purple_action_menu_set_callback:
* @act: The menu action.
- * @callback: The callback.
+ * @callback: (scope notified): The callback.
*
* Set the callback that will be used by the PurpleActionMenu.
*/
--- a/libpurple/conversation.h Tue Nov 12 03:02:55 2019 +0000
+++ b/libpurple/conversation.h Fri Nov 15 02:23:03 2019 +0000
@@ -438,7 +438,7 @@
*
* Gets current conversation's E2EE state.
*
- * Returns: Current E2EE state for conversation.
+ * Returns: (transfer none): Current E2EE state for conversation.
*/
PurpleE2eeState *
purple_conversation_get_e2ee_state(PurpleConversation *conv);
--- a/libpurple/core.h Tue Nov 12 03:02:55 2019 +0000
+++ b/libpurple/core.h Fri Nov 15 02:23:03 2019 +0000
@@ -151,7 +151,7 @@
* This is used to connect to
* <link linkend="chapter-signals-core">core signals</link>.
*
- * Returns: A handle to the purple core.
+ * Returns: (transfer none): A handle to the purple core.
*/
PurpleCore *purple_get_core(void);
--- a/libpurple/e2ee.h Tue Nov 12 03:02:55 2019 +0000
+++ b/libpurple/e2ee.h Fri Nov 15 02:23:03 2019 +0000
@@ -51,7 +51,7 @@
*
* State objects are global (shared between multiple conversations).
*
- * Returns: New E2EE state.
+ * Returns: (transfer full): New E2EE state.
*/
PurpleE2eeState *
purple_e2ee_state_new(PurpleE2eeProvider *provider);
@@ -73,7 +73,7 @@
*
* If the reference count reaches zero, the state will be freed.
*
- * Returns: @state or %NULL if the reference count reached zero.
+ * Returns: (transfer full): @state or %NULL if the reference count reached zero.
*/
PurpleE2eeState *
purple_e2ee_state_unref(PurpleE2eeState *state);
@@ -84,7 +84,7 @@
*
* Gets the provider of specified E2EE state.
*
- * Returns: The provider for this state.
+ * Returns: (transfer none): The provider for this state.
*/
PurpleE2eeProvider *
purple_e2ee_state_get_provider(PurpleE2eeState *state);
@@ -142,7 +142,7 @@
*
* Creates new E2EE provider.
*
- * Returns: New E2EE provider.
+ * Returns: (transfer full): New E2EE provider.
*/
PurpleE2eeProvider *
purple_e2ee_provider_new(void);
@@ -187,7 +187,7 @@
*
* Gets main E2EE provider.
*
- * Returns: The main E2EE provider.
+ * Returns: (transfer none): The main E2EE provider.
*/
PurpleE2eeProvider *
purple_e2ee_provider_get_main(void);
--- a/libpurple/keyring.h Tue Nov 12 03:02:55 2019 +0000
+++ b/libpurple/keyring.h Fri Nov 15 02:23:03 2019 +0000
@@ -359,7 +359,7 @@
*
* Reads settings from current keyring.
*
- * Returns: New copy of current settings (must be free'd with
+ * Returns: (transfer full): New copy of current settings (must be free'd with
* purple_request_fields_destroy).
*/
PurpleRequestFields *
--- a/libpurple/media-gst.h Tue Nov 12 03:02:55 2019 +0000
+++ b/libpurple/media-gst.h Fri Nov 15 02:23:03 2019 +0000
@@ -116,7 +116,7 @@
*
* Gets the source from a session
*
- * Returns: The source retrieved.
+ * Returns: (transfer none): The source retrieved.
*/
GstElement *purple_media_get_src(PurpleMedia *media, const gchar *sess_id);
@@ -128,7 +128,7 @@
*
* Gets the tee from a given session/stream.
*
- * Returns: The GstTee element from the chosen session/stream.
+ * Returns: (transfer none): The GstTee element from the chosen session/stream.
*/
GstElement *purple_media_get_tee(PurpleMedia *media,
const gchar *session_id, const gchar *participant);
--- a/libpurple/media/codec.h Tue Nov 12 03:02:55 2019 +0000
+++ b/libpurple/media/codec.h Fri Nov 15 02:23:03 2019 +0000
@@ -149,7 +149,7 @@
*
* Gets an optional parameter based on the values given.
*
- * Returns: The value found or NULL.
+ * Returns: (transfer none): The value found or NULL.
*/
PurpleKeyValuePair *purple_media_codec_get_optional_parameter(
PurpleMediaCodec *codec, const gchar *name,
--- a/libpurple/network.h Tue Nov 12 03:02:55 2019 +0000
+++ b/libpurple/network.h Fri Nov 15 02:23:03 2019 +0000
@@ -165,7 +165,7 @@
* poking) for IPv6-only listeners (if an IPv6 socket supports v4-mapped
* addresses, a mapping is done).
*
- * Returns: A pointer to a data structure that can be used to cancel
+ * Returns: (transfer full): A pointer to a data structure that can be used to cancel
* the pending listener, or %NULL if unable to obtain a local
* socket to listen on.
*/
@@ -213,7 +213,7 @@
* poking) for IPv6-only listeners (if an IPv6 socket supports v4-mapped
* addresses, a mapping is done).
*
- * Returns: A pointer to a data structure that can be used to cancel
+ * Returns: (transfer full): A pointer to a data structure that can be used to cancel
* the pending listener, or %NULL if unable to obtain a local
* socket to listen on.
*/
--- a/libpurple/notify.h Tue Nov 12 03:02:55 2019 +0000
+++ b/libpurple/notify.h Fri Nov 15 02:23:03 2019 +0000
@@ -314,7 +314,7 @@
*
* Returns a newly created search results object.
*
- * Returns: The new search results object.
+ * Returns: (transfer full): The new search results object.
*/
PurpleNotifySearchResults *purple_notify_searchresults_new(void);
@@ -325,7 +325,7 @@
* Returns a newly created search result column object. The column defaults
* to being visible.
*
- * Returns: The new search column object.
+ * Returns: (transfer full): The new search column object.
*/
PurpleNotifySearchColumn *purple_notify_searchresults_column_new(const char *title);
@@ -628,7 +628,7 @@
* purple_notify_user_info_prepend_pair_plaintext() are convenience
* methods for creating entries and adding them to a PurpleNotifyUserInfo.
*
- * Returns: A new PurpleNotifyUserInfoEntry
+ * Returns: (transfer full): A new PurpleNotifyUserInfoEntry
*/
PurpleNotifyUserInfoEntry *purple_notify_user_info_entry_new(const char *label, const char *value);
--- a/libpurple/pluginpref.h Tue Nov 12 03:02:55 2019 +0000
+++ b/libpurple/pluginpref.h Fri Nov 15 02:23:03 2019 +0000
@@ -73,7 +73,7 @@
*
* Create a new plugin preference frame
*
- * Returns: a new PurplePluginPrefFrame
+ * Returns: (transfer full): a new PurplePluginPrefFrame
*/
PurplePluginPrefFrame *purple_plugin_pref_frame_new(void);
@@ -109,7 +109,7 @@
*
* Create a new plugin preference
*
- * Returns: a new PurplePluginPref
+ * Returns: (transfer full): a new PurplePluginPref
*/
PurplePluginPref *purple_plugin_pref_new(void);
@@ -119,7 +119,7 @@
*
* Create a new plugin preference with name
*
- * Returns: a new PurplePluginPref
+ * Returns: (transfer full): a new PurplePluginPref
*/
PurplePluginPref *purple_plugin_pref_new_with_name(const char *name);
@@ -129,7 +129,7 @@
*
* Create a new plugin preference with label
*
- * Returns: a new PurplePluginPref
+ * Returns: (transfer full): a new PurplePluginPref
*/
PurplePluginPref *purple_plugin_pref_new_with_label(const char *label);
@@ -140,7 +140,7 @@
*
* Create a new plugin preference with name and label
*
- * Returns: a new PurplePluginPref
+ * Returns: (transfer full): a new PurplePluginPref
*/
PurplePluginPref *purple_plugin_pref_new_with_name_and_label(const char *name, const char *label);
@@ -245,7 +245,7 @@
*
* Get the choices for a choices plugin pref
*
- * Returns: (transfer none): GList of the choices
+ * Returns: (element-type void) (transfer none): GList of the choices
*/
GList *purple_plugin_pref_get_choices(PurplePluginPref *pref);
--- a/libpurple/plugins.h Tue Nov 12 03:02:55 2019 +0000
+++ b/libpurple/plugins.h Fri Nov 15 02:23:03 2019 +0000
@@ -428,7 +428,7 @@
* Returns a callback that gives extra information about a plugin. You must
* free the string returned by this callback.
*
- * Returns: The callback that returns extra information about a plugin.
+ * Returns: (transfer none): The callback that returns extra information about a plugin.
*/
PurplePluginExtraCb
purple_plugin_info_get_extra_cb(PurplePluginInfo *info);
@@ -452,7 +452,7 @@
* Returns the callback that retrieves the preferences request handle for a
* plugin, set via the "pref-request-cb" property of the plugin info.
*
- * Returns: The callback that returns the preferences request handle.
+ * Returns: (transfer none): The callback that returns the preferences request handle.
*/
PurplePluginPrefRequestCb
purple_plugin_info_get_pref_request_cb(PurplePluginInfo *info);
--- a/libpurple/pounce.h Tue Nov 12 03:02:55 2019 +0000
+++ b/libpurple/pounce.h Fri Nov 15 02:23:03 2019 +0000
@@ -102,7 +102,7 @@
*
* Creates a new buddy pounce.
*
- * Returns: The new buddy pounce structure.
+ * Returns: (transfer full): The new buddy pounce structure.
*/
PurplePounce *purple_pounce_new(const char *ui_type, PurpleAccount *pouncer,
const char *pouncee, PurplePounceEvent event,
@@ -330,7 +330,7 @@
*
* Finds a pounce with the specified event(s) and buddy.
*
- * Returns: The pounce if found, or %NULL otherwise.
+ * Returns: (transfer none): The pounce if found, or %NULL otherwise.
*/
PurplePounce *purple_find_pounce(PurpleAccount *pouncer,
const char *pouncee, PurplePounceEvent events);
--- a/libpurple/protocol.h Tue Nov 12 03:02:55 2019 +0000
+++ b/libpurple/protocol.h Fri Nov 15 02:23:03 2019 +0000
@@ -728,7 +728,7 @@
*
* Returns the whiteboard ops of a protocol.
*
- * Returns: The whiteboard ops of the protocol.
+ * Returns: (transfer none): The whiteboard ops of the protocol.
*/
PurpleWhiteboardOps *purple_protocol_get_whiteboard_ops(const PurpleProtocol *protocol);
--- a/libpurple/purpleaccountoption.h Tue Nov 12 03:02:55 2019 +0000
+++ b/libpurple/purpleaccountoption.h Fri Nov 15 02:23:03 2019 +0000
@@ -69,7 +69,7 @@
*
* Creates a newly allocated copy of @option.
*
- * Returns: (transfer: full): A new copy of @option.
+ * Returns: (transfer full): A new copy of @option.
*
* Since: 3.0.0
*/
--- a/libpurple/request-datasheet.h Tue Nov 12 03:02:55 2019 +0000
+++ b/libpurple/request-datasheet.h Fri Nov 15 02:23:03 2019 +0000
@@ -64,7 +64,7 @@
*
* Creates new Datasheet.
*
- * Returns: The new datasheet.
+ * Returns: (transfer full): The new datasheet.
*/
PurpleRequestDatasheet *
purple_request_datasheet_new(void);
@@ -176,7 +176,7 @@
*
* Creates new datasheet action.
*
- * Returns: The new action.
+ * Returns: (transfer full): The new action.
*/
PurpleRequestDatasheetAction *
purple_request_datasheet_action_new(void);
@@ -215,7 +215,7 @@
/**
* purple_request_datasheet_action_set_cb:
* @act: The action.
- * @cb: The callback function.
+ * @cb: (scope notified): The callback function.
* @user_data: The data to be passed to the callback function.
*
* Sets the callback for the action.
@@ -238,7 +238,7 @@
/**
* purple_request_datasheet_action_set_sens_cb:
* @act: The action.
- * @cb: The callback function, may be %NULL.
+ * @cb: (scope notified): The callback function, may be %NULL.
* @user_data: The data to be passed to the callback function.
*
* Sets the sensitivity checker for the action.
@@ -287,7 +287,7 @@
*
* Returns the datasheet of a record.
*
- * Returns: The datasheet.
+ * Returns: (transfer none): The datasheet.
*/
PurpleRequestDatasheet *
purple_request_datasheet_record_get_datasheet(
@@ -300,7 +300,7 @@
*
* Looks up for a record in datasheet.
*
- * Returns: The record if found, %NULL otherwise.
+ * Returns: (transfer none): The record if found, %NULL otherwise.
*/
PurpleRequestDatasheetRecord *
purple_request_datasheet_record_find(PurpleRequestDatasheet *sheet,
@@ -315,7 +315,7 @@
*
* If the specified key already exists in datasheet, old record is returned.
*
- * Returns: The record.
+ * Returns: (transfer full): The record.
*/
PurpleRequestDatasheetRecord *
purple_request_datasheet_record_add(PurpleRequestDatasheet *sheet,
--- a/libpurple/request.h Tue Nov 12 03:02:55 2019 +0000
+++ b/libpurple/request.h Fri Nov 15 02:23:03 2019 +0000
@@ -280,7 +280,7 @@
* Creates new parameters set for the request, which may or may not be used by
* the UI to display the request.
*
- * Returns: The new parameters set.
+ * Returns: (transfer full): The new parameters set.
*/
PurpleRequestCommonParameters *
purple_request_cpar_new(void);
@@ -291,7 +291,7 @@
*
* Creates new parameters set initially bound with the #PurpleConnection.
*
- * Returns: The new parameters set.
+ * Returns: (transfer full): The new parameters set.
*/
PurpleRequestCommonParameters *
purple_request_cpar_from_connection(PurpleConnection *gc);
@@ -302,7 +302,7 @@
*
* Creates new parameters set initially bound with the #PurpleAccount.
*
- * Returns: The new parameters set.
+ * Returns: (transfer full): The new parameters set.
*/
PurpleRequestCommonParameters *
purple_request_cpar_from_account(PurpleAccount *account);
@@ -313,7 +313,7 @@
*
* Creates new parameters set initially bound with the #PurpleConversation.
*
- * Returns: The new parameters set.
+ * Returns: (transfer full): The new parameters set.
*/
PurpleRequestCommonParameters *
purple_request_cpar_from_conversation(PurpleConversation *conv);
@@ -335,7 +335,7 @@
*
* The object will be destroyed when this reaches 0.
*
- * Returns: The NULL, if object was destroyed, cpar otherwise.
+ * Returns: (transfer full): The NULL, if object was destroyed, cpar otherwise.
*/
PurpleRequestCommonParameters *
purple_request_cpar_unref(PurpleRequestCommonParameters *cpar);
@@ -484,7 +484,7 @@
/**
* purple_request_cpar_set_help_cb:
* @cpar: The parameters set.
- * @cb: The callback.
+ * @cb: (scope notified): The callback.
* @user_data: The data to be passed to the callback.
*
* Sets the callback for the Help button.
@@ -501,7 +501,7 @@
*
* Gets the callback for the Help button.
*
- * Returns: The callback.
+ * Returns: (transfer none): The callback.
*/
PurpleRequestHelpCb
purple_request_cpar_get_help_cb(PurpleRequestCommonParameters *cpar,
@@ -528,7 +528,7 @@
*
* Gets extra actions for the PurpleRequestFields dialog.
*
- * Returns: (transfer none): A list of actions (pairs of arguments, as in
+ * Returns: (element-type void) (transfer none): A list of actions (pairs of arguments, as in
* setter).
*/
GSList *
@@ -566,7 +566,7 @@
*
* Creates a list of fields to pass to purple_request_fields().
*
- * Returns: A PurpleRequestFields structure.
+ * Returns: (transfer full): A PurpleRequestFields structure.
*/
PurpleRequestFields *purple_request_fields_new(void);
@@ -707,7 +707,7 @@
*
* Return the field with the specified ID.
*
- * Returns: The field, if found.
+ * Returns: (transfer none): The field, if found.
*/
PurpleRequestField *purple_request_fields_get_field(
const PurpleRequestFields *fields, const char *id);
@@ -804,7 +804,7 @@
*
* Creates a fields group with an optional title.
*
- * Returns: A new fields group
+ * Returns: (transfer full): A new fields group
*/
PurpleRequestFieldGroup *purple_request_field_group_new(const char *title);
@@ -895,7 +895,7 @@
*
* Creates a field of the specified type.
*
- * Returns: The new field.
+ * Returns: (transfer full): The new field.
*/
PurpleRequestField *purple_request_field_new(const char *id, const char *text,
PurpleRequestFieldType type);
@@ -978,7 +978,7 @@
*
* Returns the group for the field.
*
- * Returns: The UI data.
+ * Returns: (transfer none): The UI data.
*/
PurpleRequestFieldGroup *purple_request_field_get_group(const PurpleRequestField *field);
@@ -1055,7 +1055,7 @@
/**
* purple_request_field_set_validator:
* @field: The field.
- * @validator: The validator callback, NULL to disable validation.
+ * @validator: (scope notified): The validator callback, NULL to disable validation.
* @user_data: The data to pass to the callback.
*
* Sets validator for a single field.
@@ -1114,7 +1114,7 @@
/**
* purple_request_field_set_sensitivity_cb:
* @field: The field.
- * @cb: The callback.
+ * @cb: (scope notified): The callback.
*
* Sets the callback, used to determine if the field should be editable.
*/
@@ -1154,7 +1154,7 @@
*
* Creates a string request field.
*
- * Returns: The new field.
+ * Returns: (transfer full): The new field.
*/
PurpleRequestField *purple_request_field_string_new(const char *id,
const char *text,
@@ -1247,7 +1247,7 @@
*
* Creates an integer field.
*
- * Returns: The new field.
+ * Returns: (transfer full): The new field.
*/
PurpleRequestField *purple_request_field_int_new(const char *id,
const char *text, int default_value, int lower_bound, int upper_bound);
@@ -1343,7 +1343,7 @@
*
* This is often represented as a checkbox.
*
- * Returns: The new field.
+ * Returns: (transfer full): The new field.
*/
PurpleRequestField *purple_request_field_bool_new(const char *id,
const char *text,
@@ -1404,7 +1404,7 @@
*
* This is often represented as a group of radio buttons.
*
- * Returns: The new field.
+ * Returns: (transfer full): The new field.
*/
PurpleRequestField *
purple_request_field_choice_new(const char *id, const char *text,
@@ -1472,7 +1472,7 @@
*
* Returns a list of elements in a choice field.
*
- * Returns: (transfer none): The list of pairs of {label, value}.
+ * Returns: (element-type void) (transfer none): The list of pairs of {label, value}.
*/
GList *
purple_request_field_choice_get_elements(const PurpleRequestField *field);
@@ -1499,7 +1499,7 @@
*
* Creates a multiple list item field.
*
- * Returns: The new field.
+ * Returns: (transfer full): The new field.
*/
PurpleRequestField *purple_request_field_list_new(const char *id, const char *text);
@@ -1637,7 +1637,7 @@
*
* Creates a label field.
*
- * Returns: The new field.
+ * Returns: (transfer full): The new field.
*/
PurpleRequestField *purple_request_field_label_new(const char *id,
const char *text);
@@ -1655,7 +1655,7 @@
*
* Creates an image field.
*
- * Returns: The new field.
+ * Returns: (transfer full): The new field.
*/
PurpleRequestField *purple_request_field_image_new(const char *id, const char *text,
const char *buf, gsize size);
@@ -1724,7 +1724,7 @@
*
* By default, this field will not show offline accounts.
*
- * Returns: The new field.
+ * Returns: (transfer full): The new field.
*/
PurpleRequestField *purple_request_field_account_new(const char *id,
const char *text,
@@ -1766,7 +1766,7 @@
/**
* purple_request_field_account_set_filter:
* @field: The account field.
- * @filter_func: The account filter function.
+ * @filter_func: (scope notified): The account filter function.
*
* Sets the account filter function in an account field.
*
@@ -1821,7 +1821,7 @@
* This function will determine which accounts get displayed and which
* don't.
*
- * Returns: The account filter function.
+ * Returns: (transfer none): The account filter function.
*/
PurpleFilterAccountFunc purple_request_field_account_get_filter(
const PurpleRequestField *field);
@@ -1838,7 +1838,7 @@
*
* Creates a datasheet item field.
*
- * Returns: The new field.
+ * Returns: (transfer full): The new field.
*/
PurpleRequestField *purple_request_field_datasheet_new(const char *id,
const gchar *text, PurpleRequestDatasheet *sheet);
@@ -1922,11 +1922,11 @@
* Use "html", for example, to allow the user to enter HTML.
* @ok_text: The text for the <literal>OK</literal> button, which may not
* be %NULL.
- * @ok_cb: The callback for the <literal>OK</literal> button, which may
+ * @ok_cb: (scope notified): The callback for the <literal>OK</literal> button, which may
* not be %NULL.
* @cancel_text: The text for the <literal>Cancel</literal> button, which may
* not be %NULL.
- * @cancel_cb: The callback for the <literal>Cancel</literal> button, which
+ * @cancel_cb: (scope notified): The callback for the <literal>Cancel</literal> button, which
* may be %NULL.
* @cpar: The #PurpleRequestCommonParameters object, which gets
* unref'ed after this call.
@@ -1958,11 +1958,11 @@
* listed in the varargs.
* @ok_text: The text for the <literal>OK</literal> button, which may not
* be %NULL.
- * @ok_cb: The callback for the <literal>OK</literal> button, which may
+ * @ok_cb: (scope notified): The callback for the <literal>OK</literal> button, which may
* not be %NULL.
* @cancel_text: The text for the <literal>Cancel</literal> button, which may
* not be %NULL.
- * @cancel_cb: The callback for the <literal>Cancel</literal> button, or
+ * @cancel_cb: (scope notified): The callback for the <literal>Cancel</literal> button, or
* %NULL to do nothing.
* @cpar: The #PurpleRequestCommonParameters object, which gets
* unref'ed after this call.
@@ -1996,11 +1996,11 @@
* listed in the varargs.
* @ok_text: The text for the <literal>OK</literal> button, which may not
* be %NULL.
- * @ok_cb: The callback for the <literal>OK</literal> button, which may
+ * @ok_cb: (scope notified): The callback for the <literal>OK</literal> button, which may
* not be %NULL.
* @cancel_text: The text for the <literal>Cancel</literal> button, which may
* not be %NULL.
- * @cancel_cb: The callback for the <literal>Cancel</literal> button, or
+ * @cancel_cb: (scope notified): The callback for the <literal>Cancel</literal> button, or
* %NULL to do nothing.
* @cpar: The #PurpleRequestCommonParameters object, which gets
* unref'ed after this call.
@@ -2104,7 +2104,7 @@
* @secondary: Secondary information, or %NULL if there is none.
* @with_progress: %TRUE, if we want to display progress bar, %FALSE
* otherwise
- * @cancel_cb: The callback for the <literal>Cancel</literal> button, which
+ * @cancel_cb: (scope notified): The callback for the <literal>Cancel</literal> button, which
* may be %NULL.
* @cpar: The #PurpleRequestCommonParameters object, which gets
* unref'ed after this call.
@@ -2154,12 +2154,12 @@
* @fields: The list of fields.
* @ok_text: The text for the <literal>OK</literal> button, which may not be
* %NULL.
- * @ok_cb: The callback for the <literal>OK</literal> button, which may
+ * @ok_cb: (scope notified): The callback for the <literal>OK</literal> button, which may
* not be
* %NULL.
* @cancel_text: The text for the <literal>Cancel</literal> button, which may
* not be %NULL.
- * @cancel_cb: The callback for the <literal>Cancel</literal> button, which
+ * @cancel_cb: (scope notified): The callback for the <literal>Cancel</literal> button, which
* may be %NULL.
* @cpar: The #PurpleRequestCommonParameters object, which gets
* unref'ed after this call.
@@ -2311,8 +2311,8 @@
* @filename: The default filename (may be %NULL)
* @savedialog: True if this dialog is being used to save a file. False if
* it is being used to open a file.
- * @ok_cb: The callback for the <literal>OK</literal> button.
- * @cancel_cb: The callback for the <literal>Cancel</literal> button, which
+ * @ok_cb: (scope notified): The callback for the <literal>OK</literal> button.
+ * @cancel_cb: (scope notified): The callback for the <literal>Cancel</literal> button, which
* may be %NULL.
* @cpar: The #PurpleRequestCommonParameters object, which gets unref'ed
* after this call.
@@ -2335,8 +2335,8 @@
* purple_request_input().
* @title: The title of the message, or %NULL if it should have no title.
* @dirname: The default directory name (may be %NULL)
- * @ok_cb: The callback for the <literal>OK</literal> button.
- * @cancel_cb: The callback for the <literal>Cancel</literal> button, which
+ * @ok_cb: (scope notified): The callback for the <literal>OK</literal> button.
+ * @cancel_cb: (scope notified): The callback for the <literal>Cancel</literal> button, which
* may be %NULL.
* @cpar: The #PurpleRequestCommonParameters object, which gets unref'ed
* after this call.
--- a/libpurple/savedstatuses.h Tue Nov 12 03:02:55 2019 +0000
+++ b/libpurple/savedstatuses.h Fri Nov 15 02:23:03 2019 +0000
@@ -396,7 +396,7 @@
*
* Get the substatus for an account in a saved status.
*
- * Returns: The PurpleSavedStatusSub for the account, or NULL if
+ * Returns: (transfer none): The PurpleSavedStatusSub for the account, or NULL if
* the given account does not have a substatus that
* differs from the default status of this PurpleSavedStatus.
*/
--- a/libpurple/signals.h Tue Nov 12 03:02:55 2019 +0000
+++ b/libpurple/signals.h Fri Nov 15 02:23:03 2019 +0000
@@ -79,7 +79,7 @@
* purple_signal_register:
* @instance: The instance to register the signal for.
* @signal: The signal name.
- * @marshal: The marshal function.
+ * @marshal: (scope notified): The marshal function.
* @ret_type: The return type, or G_TYPE_NONE for no return type.
* @num_values: The number of values to be passed to the callbacks.
* @...: The types of the parameters for the callbacks.
@@ -130,7 +130,7 @@
* @instance: The instance to connect to.
* @signal: The name of the signal to connect.
* @handle: The handle of the receiver.
- * @func: The callback function.
+ * @func: (scope notified): The callback function.
* @data: The data to pass to the callback function.
* @priority: The priority with which the handler should be called. Signal
* handlers are called in ascending numerical order of
@@ -154,7 +154,7 @@
* @instance: The instance to connect to.
* @signal: The name of the signal to connect.
* @handle: The handle of the receiver.
- * @func: The callback function.
+ * @func: (scope notified): The callback function.
* @data: The data to pass to the callback function.
*
* Connects a signal handler to a signal for a particular object.
@@ -175,7 +175,7 @@
* @instance: The instance to connect to.
* @signal: The name of the signal to connect.
* @handle: The handle of the receiver.
- * @func: The callback function.
+ * @func: (scope notified): The callback function.
* @data: The data to pass to the callback function.
* @priority: The priority with which the handler should be called. Signal
* handlers are called in ascending numerical order of
@@ -202,7 +202,7 @@
* @instance: The instance to connect to.
* @signal: The name of the signal to connect.
* @handle: The handle of the receiver.
- * @func: The callback function.
+ * @func: (scope notified): The callback function.
* @data: The data to pass to the callback function.
*
* Connects a signal handler to a signal for a particular object.
@@ -226,7 +226,7 @@
* @instance: The instance to disconnect from.
* @signal: The name of the signal to disconnect.
* @handle: The handle of the receiver.
- * @func: The registered function to disconnect.
+ * @func: (scope call): The registered function to disconnect.
*
* Disconnects a signal handler from a signal on an object.
*
--- a/libpurple/status.h Tue Nov 12 03:02:55 2019 +0000
+++ b/libpurple/status.h Fri Nov 15 02:23:03 2019 +0000
@@ -495,7 +495,7 @@
* purple_status_set_active_with_attrs_list:
* @status: The status.
* @active: The active state.
- * @attrs: A list of attributes to set on the status. This list is
+ * @attrs: (element-type void): A list of attributes to set on the status. This list is
* composed of key/value pairs, where each key is a valid
* attribute name for this PurpleStatusType. The list is
* not modified or freed by this function.
--- a/libpurple/stringref.h Tue Nov 12 03:02:55 2019 +0000
+++ b/libpurple/stringref.h Fri Nov 15 02:23:03 2019 +0000
@@ -43,7 +43,7 @@
* Creates an immutable reference-counted string object. The newly
* created object will have a reference count of 1.
*
- * Returns: A newly allocated string reference object with a refcount
+ * Returns: (transfer full): A newly allocated string reference object with a refcount
* of 1.
*/
PurpleStringref *purple_stringref_new(const char *value);
@@ -58,7 +58,7 @@
* not referenced before the next iteration of the mainloop it will
* be freed at that time.
*
- * Returns: A newly allocated string reference object with a refcount
+ * Returns: (transfer full): A newly allocated string reference object with a refcount
* of zero.
*/
PurpleStringref *purple_stringref_new_noref(const char *value);
@@ -83,7 +83,7 @@
*
* Increase the reference count of the given stringref.
*
- * Returns: A pointer to the referenced string.
+ * Returns: (transfer full): A pointer to the referenced string.
*/
PurpleStringref *purple_stringref_ref(PurpleStringref *stringref);
--- a/libpurple/stun.h Tue Nov 12 03:02:55 2019 +0000
+++ b/libpurple/stun.h Fri Nov 15 02:23:03 2019 +0000
@@ -102,7 +102,7 @@
* is already done. Otherwise the callback is called when the discovery is over
* and NULL is returned.
*
- * Returns: a #PurpleStunNatDiscovery which includes the public IP and the type
+ * Returns: (transfer none): a #PurpleStunNatDiscovery which includes the public IP and the type
* of NAT or NULL if discovery would block
*/
PurpleStunNatDiscovery *purple_stun_discover(PurpleStunCallback cb);
--- a/libpurple/upnp.h Tue Nov 12 03:02:55 2019 +0000
+++ b/libpurple/upnp.h Fri Nov 15 02:23:03 2019 +0000
@@ -101,7 +101,7 @@
* this purple client. Essentially, this function takes care of the port
* forwarding so things like file transfers can work behind NAT firewalls
*
- * Returns: Data which can be passed to purple_upnp_cancel_port_mapping() to
+ * Returns: (transfer full): Data which can be passed to purple_upnp_cancel_port_mapping() to
* cancel
*/
PurpleUPnPMappingAddRemove *purple_upnp_set_port_mapping(unsigned short portmap, const gchar* protocol,
@@ -120,7 +120,7 @@
* port forwarding after they have completed a connection so another client on
* the local network can take advantage of the port forwarding
*
- * Returns: Data which can be passed to purple_upnp_cancel_port_mapping() to
+ * Returns: (transfer full): Data which can be passed to purple_upnp_cancel_port_mapping() to
* cancel
*/
PurpleUPnPMappingAddRemove *purple_upnp_remove_port_mapping(unsigned short portmap,
--- a/pidgin/gtkprefs.h Tue Nov 12 03:02:55 2019 +0000
+++ b/pidgin/gtkprefs.h Fri Nov 15 02:23:03 2019 +0000
@@ -136,7 +136,7 @@
* @title: The text to be displayed as the dropdown label
* @type: The type of preference to be stored in the dropdown
* @key: The key of the pref that will be represented by the dropdown
- * @menuitems: The choices to be added to the dropdown, choices should
+ * @menuitems: (element-type void): The choices to be added to the dropdown, choices should
* be paired as label/value
*
* Add a new dropdown representing a preference of the specified type
--- a/pidgin/gtkxfer.h Tue Nov 12 03:02:55 2019 +0000
+++ b/pidgin/gtkxfer.h Fri Nov 15 02:23:03 2019 +0000
@@ -152,7 +152,7 @@
*
* Returns pirgin's main file transfer dialog.
*
- * Returns: The main dialog.
+ * Returns: (transfer none): The main dialog.
*/
PidginXferDialog *pidgin_get_xfer_dialog(void);
--- a/pidgin/pidginaccountchooser.h Tue Nov 12 03:02:55 2019 +0000
+++ b/pidgin/pidginaccountchooser.h Fri Nov 15 02:23:03 2019 +0000
@@ -58,7 +58,7 @@
/**
* pidgin_account_chooser_set_filter_func:
* @chooser: The account chooser combo box.
- * @filter_func: A function for checking if an account should be shown. This
+ * @filter_func: (scope notified): A function for checking if an account should be shown. This
* can be %NULL to remove any filter.
*
* Set the filter function used to determine which accounts to show.