Mercurial > pidgin3 / changeset

--- a/libpurple/action.h	Fri Oct 25 05:52:30 2019 -0400
+++ b/libpurple/action.h	Sat Oct 26 16:09:13 2019 +0300
@@ -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: (skip) (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: (skip) (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	Fri Oct 25 05:52:30 2019 -0400
+++ b/libpurple/conversation.h	Sat Oct 26 16:09:13 2019 +0300
@@ -438,7 +438,7 @@
  *
  * Gets current conversation's E2EE state.
  *
- * Returns: Current E2EE state for conversation.
+ * Returns: (skip) (transfer none): Current E2EE state for conversation.
  */
 PurpleE2eeState *
 purple_conversation_get_e2ee_state(PurpleConversation *conv);

--- a/libpurple/core.h	Fri Oct 25 05:52:30 2019 -0400
+++ b/libpurple/core.h	Sat Oct 26 16:09:13 2019 +0300
@@ -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: (skip) (transfer none): A handle to the purple core.
  */
 PurpleCore *purple_get_core(void);
 

--- a/libpurple/e2ee.h	Fri Oct 25 05:52:30 2019 -0400
+++ b/libpurple/e2ee.h	Sat Oct 26 16:09:13 2019 +0300
@@ -51,7 +51,7 @@
  *
  * State objects are global (shared between multiple conversations).
  *
- * Returns: New E2EE state.
+ * Returns: (skip) (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: (skip) (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: (skip) (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: (skip) (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: (skip) (transfer none): The main E2EE provider.
  */
 PurpleE2eeProvider *
 purple_e2ee_provider_get_main(void);
@@ -235,7 +235,7 @@
  *
  * Gets the conversation menu callback of the E2EE provider.
  *
- * Returns: The callback.
+ * Returns: (skip): The callback.
  */
 PurpleE2eeConvMenuCallback
 purple_e2ee_provider_get_conv_menu_cb(PurpleE2eeProvider *provider);

--- a/libpurple/keyring.h	Fri Oct 25 05:52:30 2019 -0400
+++ b/libpurple/keyring.h	Sat Oct 26 16:09:13 2019 +0300
@@ -359,7 +359,7 @@
  *
  * Reads settings from current keyring.
  *
- * Returns: New copy of current settings (must be free'd with
+ * Returns: (skip) (transfer full): New copy of current settings (must be free'd with
  *         purple_request_fields_destroy).
  */
 PurpleRequestFields *

--- a/libpurple/log.h	Fri Oct 25 05:52:30 2019 -0400
+++ b/libpurple/log.h	Sat Oct 26 16:09:13 2019 +0300
@@ -555,7 +555,7 @@
  *
  * Creates a new logger
  *
- * Returns: (transfer full): The new logger.
+ * Returns: (skip) (transfer full): The new logger.
  */
 PurpleLogLogger *purple_log_logger_new(const char *id, const char *name, int functions, ...);
 

--- a/libpurple/media-gst.h	Fri Oct 25 05:52:30 2019 -0400
+++ b/libpurple/media-gst.h	Sat Oct 26 16:09:13 2019 +0300
@@ -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	Fri Oct 25 05:52:30 2019 -0400
+++ b/libpurple/media/codec.h	Sat Oct 26 16:09:13 2019 +0300
@@ -149,7 +149,7 @@
  *
  * Gets an optional parameter based on the values given.
  *
- * Returns: The value found or NULL.
+ * Returns: (skip) (transfer none): The value found or NULL.
  */
 PurpleKeyValuePair *purple_media_codec_get_optional_parameter(
 		PurpleMediaCodec *codec, const gchar *name,

--- a/libpurple/network.h	Fri Oct 25 05:52:30 2019 -0400
+++ b/libpurple/network.h	Sat Oct 26 16:09:13 2019 +0300
@@ -147,7 +147,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: (skip) (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.
  */
@@ -195,7 +195,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: (skip) (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	Fri Oct 25 05:52:30 2019 -0400
+++ b/libpurple/notify.h	Sat Oct 26 16:09:13 2019 +0300
@@ -314,7 +314,7 @@
  *
  * Returns a newly created search results object.
  *
- * Returns: The new search results object.
+ * Returns: (skip) (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: (skip) (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: (skip) (transfer full): A new PurpleNotifyUserInfoEntry
  */
 PurpleNotifyUserInfoEntry *purple_notify_user_info_entry_new(const char *label, const char *value);
 

--- a/libpurple/pluginpref.h	Fri Oct 25 05:52:30 2019 -0400
+++ b/libpurple/pluginpref.h	Sat Oct 26 16:09:13 2019 +0300
@@ -73,7 +73,7 @@
  *
  * Create a new plugin preference frame
  *
- * Returns: a new PurplePluginPrefFrame
+ * Returns: (skip) (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: (skip) (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: (skip) (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: (skip) (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: (skip) (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	Fri Oct 25 05:52:30 2019 -0400
+++ b/libpurple/plugins.h	Sat Oct 26 16:09:13 2019 +0300
@@ -415,7 +415,7 @@
  * Returns the callback that retrieves the list of actions a plugin can perform
  * at that moment.
  *
- * Returns: The callback that returns a list of #PurplePluginAction
+ * Returns: (skip): The callback that returns a list of #PurplePluginAction
  *          instances corresponding to the actions a plugin can perform.
  */
 PurplePluginActionsCb
@@ -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: (skip) (transfer none): The callback that returns extra information about a plugin.
  */
 PurplePluginExtraCb
 purple_plugin_info_get_extra_cb(PurplePluginInfo *info);
@@ -440,7 +440,7 @@
  * Returns the callback that retrieves the preferences frame for a plugin, set
  * via the "pref-frame-cb" property of the plugin info.
  *
- * Returns: The callback that returns the preferences frame.
+ * Returns: (skip): The callback that returns the preferences frame.
  */
 PurplePluginPrefFrameCb
 purple_plugin_info_get_pref_frame_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: (skip) (transfer none): The callback that returns the preferences request handle.
  */
 PurplePluginPrefRequestCb
 purple_plugin_info_get_pref_request_cb(PurplePluginInfo *info);

--- a/libpurple/pounce.h	Fri Oct 25 05:52:30 2019 -0400
+++ b/libpurple/pounce.h	Sat Oct 26 16:09:13 2019 +0300
@@ -102,7 +102,7 @@
  *
  * Creates a new buddy pounce.
  *
- * Returns: The new buddy pounce structure.
+ * Returns: (skip) (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: (skip) (transfer none): The pounce if found, or %NULL otherwise.
  */
 PurplePounce *purple_find_pounce(PurpleAccount *pouncer,
 							 const char *pouncee, PurplePounceEvent events);

--- a/libpurple/protocol.h	Fri Oct 25 05:52:30 2019 -0400
+++ b/libpurple/protocol.h	Sat Oct 26 16:09:13 2019 +0300
@@ -728,7 +728,7 @@
  *
  * Returns the whiteboard ops of a protocol.
  *
- * Returns: The whiteboard ops of the protocol.
+ * Returns: (skip) (transfer none): The whiteboard ops of the protocol.
  */
 PurpleWhiteboardOps *purple_protocol_get_whiteboard_ops(const PurpleProtocol *protocol);
 

--- a/libpurple/purpleaccountoption.h	Fri Oct 25 05:52:30 2019 -0400
+++ b/libpurple/purpleaccountoption.h	Sat Oct 26 16:09:13 2019 +0300
@@ -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	Fri Oct 25 05:52:30 2019 -0400
+++ b/libpurple/request-datasheet.h	Sat Oct 26 16:09:13 2019 +0300
@@ -64,7 +64,7 @@
  *
  * Creates new Datasheet.
  *
- * Returns: The new datasheet.
+ * Returns: (skip) (transfer full): The new datasheet.
  */
 PurpleRequestDatasheet *
 purple_request_datasheet_new(void);
@@ -176,7 +176,7 @@
  *
  * Creates new datasheet action.
  *
- * Returns: The new action.
+ * Returns: (skip) (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: (skip) (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: (skip) (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: (skip) (transfer full): The record.
  */
 PurpleRequestDatasheetRecord *
 purple_request_datasheet_record_add(PurpleRequestDatasheet *sheet,

--- a/libpurple/request.h	Fri Oct 25 05:52:30 2019 -0400
+++ b/libpurple/request.h	Sat Oct 26 16:09:13 2019 +0300
@@ -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: (skip) (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: (skip) (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: (skip) (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: (skip) (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: (skip) (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: (skip) (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: (skip) (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: (skip) (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: (skip) (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: (skip) (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: (skip) (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: (skip) (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: (skip) (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: (skip) (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: (skip) (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: (skip) (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: (skip) (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: (skip) (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: (skip) (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: (skip) (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: (skip) (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.
@@ -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	Fri Oct 25 05:52:30 2019 -0400
+++ b/libpurple/savedstatuses.h	Sat Oct 26 16:09:13 2019 +0300
@@ -396,7 +396,7 @@
  *
  * Get the substatus for an account in a saved status.
  *
- * Returns: The PurpleSavedStatusSub for the account, or NULL if
+ * Returns: (skip) (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	Fri Oct 25 05:52:30 2019 -0400
+++ b/libpurple/signals.h	Sat Oct 26 16:09:13 2019 +0300
@@ -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	Fri Oct 25 05:52:30 2019 -0400
+++ b/libpurple/status.h	Sat Oct 26 16:09:13 2019 +0300
@@ -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	Fri Oct 25 05:52:30 2019 -0400
+++ b/libpurple/stringref.h	Sat Oct 26 16:09:13 2019 +0300
@@ -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: (skip) (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: (skip) (transfer full): A newly allocated string reference object with a refcount
  *         of zero.
  */
 PurpleStringref *purple_stringref_new_noref(const char *value);
@@ -72,7 +72,7 @@
  * format specification and arguments.  The created object will have a
  * reference count of 1.
  *
- * Returns: A newly allocated string reference object with a refcount
+ * Returns: (skip): A newly allocated string reference object with a refcount
  *         of 1.
  */
 PurpleStringref *purple_stringref_printf(const char *format, ...);
@@ -83,7 +83,7 @@
  *
  * Increase the reference count of the given stringref.
  *
- * Returns: A pointer to the referenced string.
+ * Returns: (skip) (transfer full): A pointer to the referenced string.
  */
 PurpleStringref *purple_stringref_ref(PurpleStringref *stringref);
 

--- a/libpurple/stun.h	Fri Oct 25 05:52:30 2019 -0400
+++ b/libpurple/stun.h	Sat Oct 26 16:09:13 2019 +0300
@@ -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: (skip) (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	Fri Oct 25 05:52:30 2019 -0400
+++ b/libpurple/upnp.h	Sat Oct 26 16:09:13 2019 +0300
@@ -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: (skip) (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: (skip) (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	Fri Oct 25 05:52:30 2019 -0400
+++ b/pidgin/gtkprefs.h	Sat Oct 26 16:09:13 2019 +0300
@@ -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	Fri Oct 25 05:52:30 2019 -0400
+++ b/pidgin/gtkxfer.h	Sat Oct 26 16:09:13 2019 +0300
@@ -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	Fri Oct 25 05:52:30 2019 -0400
+++ b/pidgin/pidginaccountchooser.h	Sat Oct 26 16:09:13 2019 +0300
@@ -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.