pidgin/pidgin

Revert (skip) annotations

2019-11-14, qarkai
80e78796edb2
Parents 299c65ce09e2
Children c085ee3f4867
Revert (skip) annotations
--- a/libpurple/action.h Sat Oct 26 20:42:26 2019 +0300
+++ b/libpurple/action.h Thu Nov 14 23:21:54 2019 +0300
@@ -75,7 +75,7 @@
*
* Creates a new PurpleActionMenu.
*
- * Returns: (skip) (transfer full): 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: (skip) (transfer none): The callback function.
+ * Returns: (transfer none): The callback function.
*/
GCallback purple_action_menu_get_callback(const PurpleActionMenu *act);
--- a/libpurple/conversation.h Sat Oct 26 20:42:26 2019 +0300
+++ b/libpurple/conversation.h Thu Nov 14 23:21:54 2019 +0300
@@ -438,7 +438,7 @@
*
* Gets current conversation's E2EE state.
*
- * Returns: (skip) (transfer none): 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 Sat Oct 26 20:42:26 2019 +0300
+++ b/libpurple/core.h Thu Nov 14 23:21:54 2019 +0300
@@ -151,7 +151,7 @@
* This is used to connect to
* <link linkend="chapter-signals-core">core signals</link>.
*
- * Returns: (skip) (transfer none): A handle to the purple core.
+ * Returns: (transfer none): A handle to the purple core.
*/
PurpleCore *purple_get_core(void);
--- a/libpurple/e2ee.h Sat Oct 26 20:42:26 2019 +0300
+++ b/libpurple/e2ee.h Thu Nov 14 23:21:54 2019 +0300
@@ -51,7 +51,7 @@
*
* State objects are global (shared between multiple conversations).
*
- * Returns: (skip) (transfer full): 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: (skip) (transfer full): @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: (skip) (transfer none): 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: (skip) (transfer full): New E2EE provider.
+ * Returns: (transfer full): New E2EE provider.
*/
PurpleE2eeProvider *
purple_e2ee_provider_new(void);
@@ -187,7 +187,7 @@
*
* Gets main E2EE provider.
*
- * Returns: (skip) (transfer none): The main E2EE provider.
+ * Returns: (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: (skip): The callback.
+ * Returns: The callback.
*/
PurpleE2eeConvMenuCallback
purple_e2ee_provider_get_conv_menu_cb(PurpleE2eeProvider *provider);
--- a/libpurple/keyring.h Sat Oct 26 20:42:26 2019 +0300
+++ b/libpurple/keyring.h Thu Nov 14 23:21:54 2019 +0300
@@ -359,7 +359,7 @@
*
* Reads settings from current keyring.
*
- * Returns: (skip) (transfer full): 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/log.h Sat Oct 26 20:42:26 2019 +0300
+++ b/libpurple/log.h Thu Nov 14 23:21:54 2019 +0300
@@ -555,7 +555,7 @@
*
* Creates a new logger
*
- * Returns: (skip) (transfer full): The new logger.
+ * Returns: (transfer full): The new logger.
*/
PurpleLogLogger *purple_log_logger_new(const char *id, const char *name, int functions, ...);
--- a/libpurple/media/codec.h Sat Oct 26 20:42:26 2019 +0300
+++ b/libpurple/media/codec.h Thu Nov 14 23:21:54 2019 +0300
@@ -149,7 +149,7 @@
*
* Gets an optional parameter based on the values given.
*
- * Returns: (skip) (transfer none): 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 Sat Oct 26 20:42:26 2019 +0300
+++ b/libpurple/network.h Thu Nov 14 23:21:54 2019 +0300
@@ -147,7 +147,7 @@
* poking) for IPv6-only listeners (if an IPv6 socket supports v4-mapped
* addresses, a mapping is done).
*
- * Returns: (skip) (transfer full): 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.
*/
@@ -195,7 +195,7 @@
* poking) for IPv6-only listeners (if an IPv6 socket supports v4-mapped
* addresses, a mapping is done).
*
- * Returns: (skip) (transfer full): 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 Sat Oct 26 20:42:26 2019 +0300
+++ b/libpurple/notify.h Thu Nov 14 23:21:54 2019 +0300
@@ -314,7 +314,7 @@
*
* Returns a newly created search results object.
*
- * Returns: (skip) (transfer full): 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: (skip) (transfer full): 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: (skip) (transfer full): 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 Sat Oct 26 20:42:26 2019 +0300
+++ b/libpurple/pluginpref.h Thu Nov 14 23:21:54 2019 +0300
@@ -73,7 +73,7 @@
*
* Create a new plugin preference frame
*
- * Returns: (skip) (transfer full): 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: (skip) (transfer full): 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: (skip) (transfer full): 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: (skip) (transfer full): 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: (skip) (transfer full): a new PurplePluginPref
+ * Returns: (transfer full): a new PurplePluginPref
*/
PurplePluginPref *purple_plugin_pref_new_with_name_and_label(const char *name, const char *label);
--- a/libpurple/plugins.h Sat Oct 26 20:42:26 2019 +0300
+++ b/libpurple/plugins.h Thu Nov 14 23:21:54 2019 +0300
@@ -415,7 +415,7 @@
* Returns the callback that retrieves the list of actions a plugin can perform
* at that moment.
*
- * Returns: (skip): The callback that returns a list of #PurplePluginAction
+ * Returns: 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: (skip) (transfer none): 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);
@@ -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: (skip): The callback that returns the preferences frame.
+ * Returns: 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: (skip) (transfer none): 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 Sat Oct 26 20:42:26 2019 +0300
+++ b/libpurple/pounce.h Thu Nov 14 23:21:54 2019 +0300
@@ -102,7 +102,7 @@
*
* Creates a new buddy pounce.
*
- * Returns: (skip) (transfer full): 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: (skip) (transfer none): 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 Sat Oct 26 20:42:26 2019 +0300
+++ b/libpurple/protocol.h Thu Nov 14 23:21:54 2019 +0300
@@ -728,7 +728,7 @@
*
* Returns the whiteboard ops of a protocol.
*
- * Returns: (skip) (transfer none): 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/request-datasheet.h Sat Oct 26 20:42:26 2019 +0300
+++ b/libpurple/request-datasheet.h Thu Nov 14 23:21:54 2019 +0300
@@ -64,7 +64,7 @@
*
* Creates new Datasheet.
*
- * Returns: (skip) (transfer full): The new datasheet.
+ * Returns: (transfer full): The new datasheet.
*/
PurpleRequestDatasheet *
purple_request_datasheet_new(void);
@@ -176,7 +176,7 @@
*
* Creates new datasheet action.
*
- * Returns: (skip) (transfer full): The new action.
+ * Returns: (transfer full): The new action.
*/
PurpleRequestDatasheetAction *
purple_request_datasheet_action_new(void);
@@ -287,7 +287,7 @@
*
* Returns the datasheet of a record.
*
- * Returns: (skip) (transfer none): 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: (skip) (transfer none): 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: (skip) (transfer full): The record.
+ * Returns: (transfer full): The record.
*/
PurpleRequestDatasheetRecord *
purple_request_datasheet_record_add(PurpleRequestDatasheet *sheet,
--- a/libpurple/request.h Sat Oct 26 20:42:26 2019 +0300
+++ b/libpurple/request.h Thu Nov 14 23:21:54 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: (skip) (transfer full): 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: (skip) (transfer full): 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: (skip) (transfer full): 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: (skip) (transfer full): 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: (skip) (transfer full): 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);
@@ -501,7 +501,7 @@
*
* Gets the callback for the Help button.
*
- * Returns: (skip) (transfer none): The callback.
+ * Returns: (transfer none): The callback.
*/
PurpleRequestHelpCb
purple_request_cpar_get_help_cb(PurpleRequestCommonParameters *cpar,
@@ -566,7 +566,7 @@
*
* Creates a list of fields to pass to purple_request_fields().
*
- * Returns: (skip) (transfer full): 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: (skip) (transfer none): 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: (skip) (transfer full): 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: (skip) (transfer full): 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: (skip) (transfer none): The UI data.
+ * Returns: (transfer none): The UI data.
*/
PurpleRequestFieldGroup *purple_request_field_get_group(const PurpleRequestField *field);
@@ -1154,7 +1154,7 @@
*
* Creates a string request field.
*
- * Returns: (skip) (transfer full): 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: (skip) (transfer full): 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: (skip) (transfer full): 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: (skip) (transfer full): The new field.
+ * Returns: (transfer full): The new field.
*/
PurpleRequestField *
purple_request_field_choice_new(const char *id, const char *text,
@@ -1499,7 +1499,7 @@
*
* Creates a multiple list item field.
*
- * Returns: (skip) (transfer full): 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: (skip) (transfer full): 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: (skip) (transfer full): 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: (skip) (transfer full): The new field.
+ * Returns: (transfer full): The new field.
*/
PurpleRequestField *purple_request_field_account_new(const char *id,
const char *text,
@@ -1821,7 +1821,7 @@
* This function will determine which accounts get displayed and which
* don't.
*
- * Returns: (skip) (transfer none): 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: (skip) (transfer full): The new field.
+ * Returns: (transfer full): The new field.
*/
PurpleRequestField *purple_request_field_datasheet_new(const char *id,
const gchar *text, PurpleRequestDatasheet *sheet);
--- a/libpurple/savedstatuses.h Sat Oct 26 20:42:26 2019 +0300
+++ b/libpurple/savedstatuses.h Thu Nov 14 23:21:54 2019 +0300
@@ -396,7 +396,7 @@
*
* Get the substatus for an account in a saved status.
*
- * Returns: (skip) (transfer none): 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/stringref.h Sat Oct 26 20:42:26 2019 +0300
+++ b/libpurple/stringref.h Thu Nov 14 23:21:54 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: (skip) (transfer full): 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: (skip) (transfer full): 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);
@@ -72,7 +72,7 @@
* format specification and arguments. The created object will have a
* reference count of 1.
*
- * Returns: (skip): A newly allocated string reference object with a refcount
+ * Returns: 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: (skip) (transfer full): 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 Sat Oct 26 20:42:26 2019 +0300
+++ b/libpurple/stun.h Thu Nov 14 23:21:54 2019 +0300
@@ -102,7 +102,7 @@
* is already done. Otherwise the callback is called when the discovery is over
* and NULL is returned.
*
- * Returns: (skip) (transfer none): 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 Sat Oct 26 20:42:26 2019 +0300
+++ b/libpurple/upnp.h Thu Nov 14 23:21:54 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: (skip) (transfer full): 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: (skip) (transfer full): 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,