--- 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 @@
- * Returns: The new datasheet.
+ * Returns: (transfer full): The new datasheet. 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:
- * @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:
- * @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. 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: (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: (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. 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 @@ -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:
- * @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:
+ * @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,
@@ -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,
@@ -1404,7 +1404,7 @@
* This is often represented as a group of radio buttons.
- * Returns: The new field.
+ * Returns: (transfer full): The new field. 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}. 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 @@
- * Returns: The new field.
+ * Returns: (transfer full): The new field. PurpleRequestField *purple_request_field_label_new(const char *id,
@@ -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,
@@ -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
- * 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
- * @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 * @cancel_text: The text for the <literal>Cancel</literal> button, which may
- * @cancel_cb: The callback for the <literal>Cancel</literal> button, which
+ * @cancel_cb: (scope notified): The callback for the <literal>Cancel</literal> button, which * @cpar: The #PurpleRequestCommonParameters object, which gets
* unref'ed after this call.
@@ -1958,11 +1958,11 @@
* @ok_text: The text for the <literal>OK</literal> button, which may not
- * @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 * @cancel_text: The text for the <literal>Cancel</literal> button, which may
- * @cancel_cb: The callback for the <literal>Cancel</literal> button, or
+ * @cancel_cb: (scope notified): The callback for the <literal>Cancel</literal> button, or * @cpar: The #PurpleRequestCommonParameters object, which gets
* unref'ed after this call.
@@ -1996,11 +1996,11 @@
* @ok_text: The text for the <literal>OK</literal> button, which may not
- * @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 * @cancel_text: The text for the <literal>Cancel</literal> button, which may
- * @cancel_cb: The callback for the <literal>Cancel</literal> button, or
+ * @cancel_cb: (scope notified): The callback for the <literal>Cancel</literal> button, or * @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
- * @cancel_cb: The callback for the <literal>Cancel</literal> button, which
+ * @cancel_cb: (scope notified): The callback for the <literal>Cancel</literal> button, which * @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
- * @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 * @cancel_text: The text for the <literal>Cancel</literal> button, which may
- * @cancel_cb: The callback for the <literal>Cancel</literal> button, which
+ * @cancel_cb: (scope notified): The callback for the <literal>Cancel</literal> button, which * @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 * @cpar: The #PurpleRequestCommonParameters object, which gets unref'ed
@@ -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 * @cpar: The #PurpleRequestCommonParameters object, which gets unref'ed
--- 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.