pidgin/pidgin

Replace a bunch of entries in ChangeLog.API entries with Since annotations
--- a/ChangeLog.API Tue Nov 19 05:03:18 2019 +0000
+++ b/ChangeLog.API Thu Nov 21 21:41:21 2019 -0600
@@ -14,57 +14,6 @@
libpurple:
Added:
* displaying-emails-clear signal (notification signal)
- * purple_account_is_disconnecting
- * purple_account_get_ui_data
- * purple_account_set_ui_data
- * purple_account_privacy_get_denied
- * purple_account_privacy_get_permitted
- * PurpleAccountPresence and PurpleBuddyPresence inherit PurplePresence
- * purple_account_presence_new
- * purple_buddy_presence_new
- * purple_account_register_completed
- * purple_blist_get_default_root
- * purple_blist_node_is_transient
- * purple_blist_node_set_transient
- * purple_certificate_get_der_data
- * purple_certificate_get_display_string
- * purple_chat_user_get_alias
- * purple_chat_user_get_chat
- * purple_chat_user_get_flags
- * purple_chat_user_is_buddy
- * purple_chat_user_get_ui_data
- * purple_chat_user_set_ui_data
- * purple_chat_user_set_chat
- * purple_connection_get_active_chats
- * purple_connection_get_error_info
- * purple_connection_get_flags
- * purple_connection_set_flags
- * purple_connection_update_last_received
- * purple_conversation_get_ui_data
- * purple_conversation_set_ui_data
- * purple_conversation_message_get_alias
- * purple_conversation_message_get_conv
- * PurpleCountingNode, inherits PurpleBlistNode
- * purple_counting_node_get_*
- * purple_counting_node_change_*
- * purple_counting_node_set_*
- * PurpleIMConversation and PurpleChatConversation inherit
- PurpleConversation
- * purple_notify_emails_pending
- * purple_notify_emails_present
- * purple_notify_searchresult_column_get_title
- * purple_notify_searchresult_column_is_visible
- * purple_notify_searchresult_column_set_visible
- * purple_notify_user_info_entry_destroy
- * purple_notify_user_info_prepend_pair_plaintext
- * purple_media_manager_enumerate_elements
- * purple_menu_action_get_callback
- * purple_menu_action_get_children
- * purple_menu_action_get_data
- * purple_menu_action_set_label
- * purple_menu_action_set_data
- * purple_menu_action_set_callback
- * purple_menu_action_set_children
* PurplePluginInfoFlags (PURPLE_PLUGIN_INFO_FLAGS_INTERNAL and
PURPLE_PLUGIN_INFO_FLAGS_AUTO_LOAD)
* purple_plugin_get_dependent_plugins
@@ -380,9 +329,7 @@
* PurpleAccoun->ui_data
* purple_account_add_buddies_with_invite
* purple_account_add_buddy_with_invite
- * purple_account_get_ui_data
* purple_account_set_current_error
- * purple_account_set_ui_data
* purple_base64_*. Use g_base64_* instead
* purple_blist_get_ui_data
* purple_blist_load
--- a/libpurple/account.h Tue Nov 19 05:03:18 2019 +0000
+++ b/libpurple/account.h Thu Nov 21 21:41:21 2019 -0600
@@ -147,6 +147,8 @@
*
* Registration of the account was completed.
* Calls the registration call-back set with purple_account_set_register_callback().
+ *
+ * Since: 3.0.0
*/
void purple_account_register_completed(PurpleAccount *account, gboolean succeeded);
@@ -176,6 +178,8 @@
* Indicates if the account is currently being disconnected.
*
* Returns: TRUE if the account is being disconnected.
+ *
+ * Since: 3.0.0
*/
gboolean purple_account_is_disconnecting(PurpleAccount *account);
@@ -890,6 +894,8 @@
* Returns the account's permit list.
*
* Returns: (transfer none) (element-type utf8): A list of the permitted users
+ *
+ * Since: 3.0.0
*/
GSList *purple_account_privacy_get_permitted(PurpleAccount *account);
@@ -900,6 +906,8 @@
* Returns the account's deny list.
*
* Returns: (transfer none) (element-type utf8): A list of the denied users
+ *
+ * Since: 3.0.0
*/
GSList *purple_account_privacy_get_denied(PurpleAccount *account);
--- a/libpurple/blistnode.h Tue Nov 19 05:03:18 2019 +0000
+++ b/libpurple/blistnode.h Thu Nov 21 21:41:21 2019 -0600
@@ -272,6 +272,8 @@
* be saved
*
* Sets whether the node should be saved with the buddy list or not
+ *
+ * Since: 3.0.0
*/
void purple_blist_node_set_transient(PurpleBlistNode *node, gboolean transient);
@@ -282,6 +284,8 @@
* Gets whether the node should be saved with the buddy list or not
*
* Returns: TRUE if the node should NOT be saved, FALSE if node should be saved
+ *
+ * Since: 3.0.0
*/
gboolean purple_blist_node_is_transient(PurpleBlistNode *node);
--- a/libpurple/connection.h Tue Nov 19 05:03:18 2019 +0000
+++ b/libpurple/connection.h Thu Nov 21 21:41:21 2019 -0600
@@ -306,6 +306,8 @@
* @flags: The flags.
*
* Sets the connection flags.
+ *
+ * Since: 3.0.0
*/
void purple_connection_set_flags(PurpleConnection *gc, PurpleConnectionFlags flags);
@@ -344,6 +346,8 @@
* Returns the connection flags.
*
* Returns: The connection flags.
+ *
+ * Since: 3.0.0
*/
PurpleConnectionFlags purple_connection_get_flags(PurpleConnection *gc);
@@ -406,6 +410,8 @@
*
* Returns: (element-type PurpleChatConversation) (transfer none): The active
* chats on the connection.
+ *
+ * Since: 3.0.0
*/
GSList *purple_connection_get_active_chats(PurpleConnection *gc);
@@ -472,7 +478,9 @@
* error exists.
*
* Returns: The #PurpleConnectionErrorInfo instance of the connection if an
- * error exists, %NULL otherwise.
+ * error exists, %NULL otherwise.
+ *
+ * Since: 3.0.0
*/
PurpleConnectionErrorInfo *
purple_connection_get_error_info(PurpleConnection *gc);
@@ -548,6 +556,8 @@
*
* Indicate that a packet was received on the connection.
* Set by the protocol to avoid sending unneeded keepalives.
+ *
+ * Since: 3.0.0
*/
void purple_connection_update_last_received(PurpleConnection *gc);
--- a/libpurple/conversation.h Tue Nov 19 05:03:18 2019 +0000
+++ b/libpurple/conversation.h Thu Nov 21 21:41:21 2019 -0600
@@ -583,6 +583,8 @@
* @ui_data: A pointer to associate with this conversation.
*
* Set the UI data associated with this conversation.
+ *
+ * Since: 3.0.0
*/
void purple_conversation_set_ui_data(PurpleConversation *conv, gpointer ui_data);
@@ -595,6 +597,8 @@
* Returns: (transfer none): The UI data associated with this conversation.
* This is a convenience field provided to the UIs--it is not
* used by the libpurple core.
+ *
+ * Since: 3.0.0
*/
gpointer purple_conversation_get_ui_data(const PurpleConversation *conv);
--- a/libpurple/conversationtypes.h Tue Nov 19 05:03:18 2019 +0000
+++ b/libpurple/conversationtypes.h Thu Nov 21 21:41:21 2019 -0600
@@ -656,6 +656,8 @@
* @chat: The chat conversation that the buddy belongs to.
*
* Set the chat conversation associated with this chat user.
+ *
+ * Since: 3.0.0
*/
void purple_chat_user_set_chat(PurpleChatUser *cb,
PurpleChatConversation *chat);
@@ -668,6 +670,8 @@
*
* Returns: (transfer none):
* The chat conversation that the buddy belongs to.
+ *
+ * Since: 3.0.0
*/
PurpleChatConversation *purple_chat_user_get_chat(PurpleChatUser *cb);
@@ -691,6 +695,8 @@
* @ui_data: A pointer to associate with this chat user.
*
* Set the UI data associated with this chat user.
+ *
+ * Since: 3.0.0
*/
void purple_chat_user_set_ui_data(PurpleChatUser *cb, gpointer ui_data);
@@ -704,6 +710,8 @@
* The UI data associated with this chat user. This is a
* convenience field provided to the UIs--it is not
* used by the libpurple core.
+ *
+ * Since: 3.0.0
*/
gpointer purple_chat_user_get_ui_data(PurpleChatUser *cb);
@@ -714,6 +722,8 @@
* Get the alias of a chat user
*
* Returns: The alias of the chat user.
+ *
+ * Since: 3.0.0
*/
const char *purple_chat_user_get_alias(PurpleChatUser *cb);
@@ -743,6 +753,8 @@
* Get the flags of a chat user.
*
* Returns: The flags of the chat user.
+ *
+ * Since: 3.0.0
*/
PurpleChatUserFlags purple_chat_user_get_flags(PurpleChatUser *cb);
@@ -753,6 +765,8 @@
* Indicates if this chat user is on the buddy list.
*
* Returns: TRUE if the chat user is on the buddy list.
+ *
+ * Since: 3.0.0
*/
gboolean purple_chat_user_is_buddy(PurpleChatUser *cb);
--- a/libpurple/countingnode.h Tue Nov 19 05:03:18 2019 +0000
+++ b/libpurple/countingnode.h Thu Nov 21 21:41:21 2019 -0600
@@ -58,6 +58,8 @@
* </orderedlist>
*
* See #PurpleContact, #PurpleGroup
+ *
+ * Since: 3.0.0
*/
struct _PurpleCountingNode {
PurpleBlistNode node;
@@ -79,6 +81,8 @@
* purple_counting_node_get_type:
*
* Returns: The #GType for the #PurpleCountingNode object.
+ *
+ * Since: 3.0.0
*/
GType purple_counting_node_get_type(void);
@@ -89,6 +93,8 @@
* Returns the total number of children of the counting node.
*
* Returns: The total number of children of the node
+ *
+ * Since: 3.0.0
*/
int purple_counting_node_get_total_size(PurpleCountingNode *counter);
@@ -100,6 +106,8 @@
* accounts.
*
* Returns: The number of children with online accounts
+ *
+ * Since: 3.0.0
*/
int purple_counting_node_get_current_size(PurpleCountingNode *counter);
@@ -110,6 +118,8 @@
* Returns the number of children of the counting node that are online.
*
* Returns: The total number of online children
+ *
+ * Since: 3.0.0
*/
int purple_counting_node_get_online_count(PurpleCountingNode *counter);
@@ -121,6 +131,8 @@
* Changes the total number of children of the counting node. The provided
* delta value is added to the count, or if it's negative, the count is
* decreased.
+ *
+ * Since: 3.0.0
*/
void purple_counting_node_change_total_size(PurpleCountingNode *counter, int delta);
@@ -132,6 +144,8 @@
* Changes the number of children of the counting node corresponding to online
* accounts. The provided delta value is added to the count, or if it's
* negative, the count is decreased.
+ *
+ * Since: 3.0.0
*/
void purple_counting_node_change_current_size(PurpleCountingNode *counter, int delta);
@@ -143,6 +157,8 @@
* Changes the number of children of the counting node that are online. The
* provided delta value is added to the count, or if it's negative, the count is
* decreased.
+ *
+ * Since: 3.0.0
*/
void purple_counting_node_change_online_count(PurpleCountingNode *counter, int delta);
@@ -152,6 +168,8 @@
* @totalsize: The total number of children of the node
*
* Sets the total number of children of the counting node.
+ *
+ * Since: 3.0.0
*/
void purple_counting_node_set_total_size(PurpleCountingNode *counter, int totalsize);
@@ -162,6 +180,8 @@
*
* Sets the number of children of the counting node corresponding to online
* accounts.
+ *
+ * Since: 3.0.0
*/
void purple_counting_node_set_current_size(PurpleCountingNode *counter, int currentsize);
@@ -171,6 +191,8 @@
* @onlinecount: The total number of online children
*
* Sets the number of children of the counting node that are online.
+ *
+ * Since: 3.0.0
*/
void purple_counting_node_set_online_count(PurpleCountingNode *counter, int onlinecount);
--- a/libpurple/media-gst.h Tue Nov 19 05:03:18 2019 +0000
+++ b/libpurple/media-gst.h Thu Nov 21 21:41:21 2019 -0600
@@ -165,6 +165,8 @@
*
* Returns: (transfer container) (element-type PurpleMediaElementInfo): A #GList of registered #PurpleMediaElementInfo instances that match
* @type.
+ *
+ * Since: 3.0.0
*/
GList *purple_media_manager_enumerate_elements(PurpleMediaManager *manager,
PurpleMediaElementType type);
--- a/libpurple/notify.h Tue Nov 19 05:03:18 2019 +0000
+++ b/libpurple/notify.h Thu Nov 21 21:41:21 2019 -0600
@@ -336,6 +336,8 @@
* Returns the title of the column
*
* Returns: The title of the column
+ *
+ * Since: 3.0.0
*/
const char *purple_notify_searchresult_column_get_title(const PurpleNotifySearchColumn *column);
@@ -345,6 +347,8 @@
* @visible: TRUE if visible, or FALSE if not.
*
* Sets whether or not a search result column is visible.
+ *
+ * Since: 3.0.0
*/
void purple_notify_searchresult_column_set_visible(PurpleNotifySearchColumn *column, gboolean visible);
@@ -355,6 +359,8 @@
* Returns whether or not a search result column is visible.
*
* Returns: TRUE if the search result column is visible. FALSE otherwise.
+ *
+ * Since: 3.0.0
*/
gboolean purple_notify_searchresult_column_is_visible(const PurpleNotifySearchColumn *column);
@@ -595,6 +601,8 @@
*
* Like purple_notify_user_info_prepend_pair_html, but value should be plaintext
* and will be escaped using g_markup_escape_text().
+ *
+ * Since: 3.0.0
*/
void purple_notify_user_info_prepend_pair_plaintext(PurpleNotifyUserInfo *user_info, const char *label, const char *value);
@@ -637,6 +645,8 @@
* @user_info_entry: The PurpleNotifyUserInfoEntry
*
* Destroy a PurpleNotifyUserInfoEntry
+ *
+ * Since: 3.0.0
*/
void purple_notify_user_info_entry_destroy(PurpleNotifyUserInfoEntry *user_info_entry);
--- a/libpurple/presence.h Tue Nov 19 05:03:18 2019 +0000
+++ b/libpurple/presence.h Thu Nov 21 21:41:21 2019 -0600
@@ -276,6 +276,8 @@
* Creates a presence for an account.
*
* Returns: The new presence.
+ *
+ * Since: 3.0.0
*/
PurpleAccountPresence *purple_account_presence_new(PurpleAccount *account);
@@ -310,6 +312,8 @@
* Creates a presence for a buddy.
*
* Returns: The new presence.
+ *
+ * Since: 3.0.0
*/
PurpleBuddyPresence *purple_buddy_presence_new(PurpleBuddy *buddy);