Mercurial > pidgin3 / changeset

changeset

Add Since and symbol visibility on remaining Pidgin API

Wed, 01 Nov 2023 03:31:45 -0500

author
Elliott Sales de Andrade <quantum.analyst@gmail.com>
date
Wed, 01 Nov 2023 03:31:45 -0500
changeset 42467
2b1d9d0770f2
parent 42466
ca3374c1cdba
child 42468
3ea8d5befbe4

Add Since and symbol visibility on remaining Pidgin API

I think this is everything, but there may be some missed Since docs.

Testing Done:
Compiled.

Bugs closed: PIDGIN-17839

Reviewed at https://reviews.imfreedom.org/r/2767/

pidgin/gtkmedia.h file | annotate | diff | comparison | revisions
pidgin/gtkrequest.h file | annotate | diff | comparison | revisions
pidgin/pidginaccountrow.h file | annotate | diff | comparison | revisions
pidgin/pidginactiongroup.h file | annotate | diff | comparison | revisions
pidgin/pidgincontactlist.h file | annotate | diff | comparison | revisions
pidgin/pidginconversation.h file | annotate | diff | comparison | revisions
pidgin/pidgincore.h file | annotate | diff | comparison | revisions
pidgin/pidgindisplaywindow.h file | annotate | diff | comparison | revisions
pidgin/pidgininfopane.h file | annotate | diff | comparison | revisions
pidgin/pidgininvitedialog.h file | annotate | diff | comparison | revisions
pidgin/pidginnotificationaddcontact.h file | annotate | diff | comparison | revisions
pidgin/pidginnotificationauthorizationrequest.h file | annotate | diff | comparison | revisions
pidgin/pidginnotificationconnectionerror.h file | annotate | diff | comparison | revisions
pidgin/pidginnotificationlist.h file | annotate | diff | comparison | revisions
pidgin/pidginpluginsmenu.h file | annotate | diff | comparison | revisions
pidgin/pidginstatusmanager.h file | annotate | diff | comparison | revisions
pidgin/pidginui.h file | annotate | diff | comparison | revisions 
--- a/pidgin/gtkmedia.h	Wed Nov 01 01:43:05 2023 -0500
+++ b/pidgin/gtkmedia.h	Wed Nov 01 03:31:45 2023 -0500
@@ -30,7 +30,7 @@
 
 G_BEGIN_DECLS
 
-PURPLE_AVAILABLE_IN_2_6
+PIDGIN_AVAILABLE_IN_2_6
 void pidgin_medias_init(void);
 
 G_END_DECLS
--- a/pidgin/gtkrequest.h	Wed Nov 01 01:43:05 2023 -0500
+++ b/pidgin/gtkrequest.h	Wed Nov 01 03:31:45 2023 -0500
@@ -53,7 +53,10 @@
  * Gets dialog window for specified libpurple request.
  *
  * Returns: (transfer none): The dialog window.
+ *
+ * Since: 3.0.0
  */
+PIDGIN_AVAILABLE_IN_3_0
 GtkWindow *
 pidgin_request_get_dialog_window(void *ui_handle);
 
@@ -67,21 +70,30 @@
  * Returns the gtk requests subsystem handle.
  *
  * Returns: The requests subsystem handle.
+ *
+ * Since: 3.0.0
  */
+PIDGIN_AVAILABLE_IN_3_0
 void *pidgin_request_get_handle(void);
 
 /**
  * pidgin_request_init:
  *
  * Initializes the GTK requests subsystem.
+ *
+ * Since: 3.0.0
  */
+PIDGIN_AVAILABLE_IN_3_0
 void pidgin_request_init(void);
 
 /**
  * pidgin_request_uninit:
  *
  * Uninitializes the GTK requests subsystem.
+ *
+ * Since: 3.0.0
  */
+PIDGIN_AVAILABLE_IN_3_0
 void pidgin_request_uninit(void);
 
 G_END_DECLS
--- a/pidgin/pidginaccountrow.h	Wed Nov 01 01:43:05 2023 -0500
+++ b/pidgin/pidginaccountrow.h	Wed Nov 01 03:31:45 2023 -0500
@@ -60,7 +60,10 @@
  * Creates a new instance.
  *
  * Returns: (transfer full): The new instance.
+ *
+ * Since: 3.0.0
  */
+PIDGIN_AVAILABLE_IN_3_0
 GtkWidget *pidgin_account_row_new(void);
 
 /**
--- a/pidgin/pidginactiongroup.h	Wed Nov 01 01:43:05 2023 -0500
+++ b/pidgin/pidginactiongroup.h	Wed Nov 01 03:31:45 2023 -0500
@@ -48,8 +48,10 @@
  *
  * A constant that represents the sort-method action to change the sorting
  * method of the buddy list.
+ *
+ * Since: 3.0.0
  */
-#define PIDGIN_ACTION_SORT_METHOD ("sort-method")
+#define PIDGIN_ACTION_SORT_METHOD ("sort-method" PIDGIN_AVAILABLE_MACRO_IN_3_0)
 
 G_BEGIN_DECLS
 
@@ -66,7 +68,10 @@
  * #GAction's in Pidgin.
  *
  * Returns: (transfer full): The new #PidginActionGroup instance.
+ *
+ * Since: 3.0.0
  */
+PIDGIN_AVAILABLE_IN_3_0
 GSimpleActionGroup *pidgin_action_group_new(void);
 
 G_END_DECLS
--- a/pidgin/pidgincontactlist.h	Wed Nov 01 01:43:05 2023 -0500
+++ b/pidgin/pidgincontactlist.h	Wed Nov 01 03:31:45 2023 -0500
@@ -60,7 +60,10 @@
  * [class@Purple.ContactManager].
  *
  * Returns: (transfer full): The new #PidginContactList instance.
+ *
+ * Since: 3.0.0
  */
+PIDGIN_AVAILABLE_IN_3_0
 GtkWidget *pidgin_contact_list_new(void);
 
 G_END_DECLS
--- a/pidgin/pidginconversation.h	Wed Nov 01 01:43:05 2023 -0500
+++ b/pidgin/pidginconversation.h	Wed Nov 01 03:31:45 2023 -0500
@@ -41,6 +41,8 @@
  * PidginConversation:
  *
  * A [class@Gtk.Widget] for displaying a [class@Purple.Conversation].
+ *
+ * Since: 2.0.0
  */
 
 #define PIDGIN_TYPE_CONVERSATION (pidgin_conversation_get_type())
--- a/pidgin/pidgincore.h	Wed Nov 01 01:43:05 2023 -0500
+++ b/pidgin/pidgincore.h	Wed Nov 01 03:31:45 2023 -0500
@@ -60,7 +60,10 @@
  * @argv: The argv from main(), or %NULL.
  *
  * Start pidgin with the given command line arguments.
+ *
+ * Since: 3.0.0
  */
+PIDGIN_AVAILABLE_IN_3_0
 int pidgin_start(int argc, char *argv[]);
 
 #endif /* PIDGIN_CORE_H */
--- a/pidgin/pidgindisplaywindow.h	Wed Nov 01 01:43:05 2023 -0500
+++ b/pidgin/pidgindisplaywindow.h	Wed Nov 01 03:31:45 2023 -0500
@@ -57,7 +57,10 @@
  * Creates a new #PidginDisplayWindow instance.
  *
  * Returns: (transfer full): The new #PidginDisplayWindow instance.
+ *
+ * Since: 3.0.0
  */
+PIDGIN_AVAILABLE_IN_3_0
 GtkWidget *pidgin_display_window_new(void);
 
 /**
--- a/pidgin/pidgininfopane.h	Wed Nov 01 01:43:05 2023 -0500
+++ b/pidgin/pidgininfopane.h	Wed Nov 01 03:31:45 2023 -0500
@@ -60,7 +60,10 @@
  * @conversation.
  *
  * Returns: (transfer full): The new #PidginInfoPane instance.
+ *
+ * Since: 3.0.0
  */
+PIDGIN_AVAILABLE_IN_3_0
 GtkWidget *pidgin_info_pane_new(PurpleConversation *conversation);
 
 /**
@@ -70,7 +73,10 @@
  * Gets the #PurpleConversation that @pane is displaying information for.
  *
  * Returns: (transfer none): The #PurpleConversation displayed by @pane.
+ *
+ * Since: 3.0.0
  */
+PIDGIN_AVAILABLE_IN_3_0
 PurpleConversation *pidgin_info_pane_get_conversation(PidginInfoPane *pane);
 
 /**
--- a/pidgin/pidgininvitedialog.h	Wed Nov 01 01:43:05 2023 -0500
+++ b/pidgin/pidgininvitedialog.h	Wed Nov 01 03:31:45 2023 -0500
@@ -63,6 +63,8 @@
  *
  * }
  * ]|
+ *
+ * Since: 3.0.0
  */
 
 #define PIDGIN_TYPE_INVITE_DIALOG  pidgin_invite_dialog_get_type()
--- a/pidgin/pidginnotificationaddcontact.h	Wed Nov 01 01:43:05 2023 -0500
+++ b/pidgin/pidginnotificationaddcontact.h	Wed Nov 01 03:31:45 2023 -0500
@@ -64,7 +64,10 @@
  *
  * Returns: (transfer full): The new #PidginNotificationAddContact
  *          instance.
+ *
+ * Since: 3.0.0
  */
+PIDGIN_AVAILABLE_IN_3_0
 GtkWidget *pidgin_notification_add_contact_new(PurpleNotification *notification);
 
 /**
--- a/pidgin/pidginnotificationauthorizationrequest.h	Wed Nov 01 01:43:05 2023 -0500
+++ b/pidgin/pidginnotificationauthorizationrequest.h	Wed Nov 01 03:31:45 2023 -0500
@@ -64,7 +64,10 @@
  *
  * Returns: (transfer full): The new #PidginNotificationAuthorizationRequest
  *          instance.
+ *
+ * Since: 3.0.0
  */
+PIDGIN_AVAILABLE_IN_3_0
 GtkWidget *pidgin_notification_authorization_request_new(PurpleNotification *notification);
 
 /**
--- a/pidgin/pidginnotificationconnectionerror.h	Wed Nov 01 01:43:05 2023 -0500
+++ b/pidgin/pidginnotificationconnectionerror.h	Wed Nov 01 03:31:45 2023 -0500
@@ -63,7 +63,10 @@
  *
  * Returns: (transfer full): The new #PidginNotificationConnectionError
  *          instance.
+ *
+ * Since: 3.0.0
  */
+PIDGIN_AVAILABLE_IN_3_0
 GtkWidget *pidgin_notification_connection_error_new(PurpleNotification *notification);
 
 /**
--- a/pidgin/pidginnotificationlist.h	Wed Nov 01 01:43:05 2023 -0500
+++ b/pidgin/pidginnotificationlist.h	Wed Nov 01 03:31:45 2023 -0500
@@ -57,7 +57,10 @@
  * notifications from the default [class@Purple.NotificationManager].
  *
  * Returns: (transfer full): The new #PidginNotificationList instance.
+ *
+ * Since: 3.0.0
  */
+PIDGIN_AVAILABLE_IN_3_0
 GtkWidget *pidgin_notification_list_new(void);
 
 G_END_DECLS
--- a/pidgin/pidginpluginsmenu.h	Wed Nov 01 01:43:05 2023 -0500
+++ b/pidgin/pidginpluginsmenu.h	Wed Nov 01 03:31:45 2023 -0500
@@ -54,7 +54,10 @@
  * Creates a new #PidginPluginsMenu instance that keeps itself up to date.
  *
  * Returns: (transfer full): The new #PidginPluginsMenu instance.
+ *
+ * Since: 3.0.0
  */
+PIDGIN_AVAILABLE_IN_3_0
 GMenuModel *pidgin_plugins_menu_new(void);
 
 G_END_DECLS
--- a/pidgin/pidginstatusmanager.h	Wed Nov 01 01:43:05 2023 -0500
+++ b/pidgin/pidginstatusmanager.h	Wed Nov 01 03:31:45 2023 -0500
@@ -55,7 +55,10 @@
  * Creates a new instance of the dialog.
  *
  * Returns: (transfer full): The new #PidginStatusManager instance.
+ *
+ * Since: 3.0.0
  */
+PIDGIN_AVAILABLE_IN_3_0
 GtkWidget *pidgin_status_manager_new(void);
 
 G_END_DECLS
--- a/pidgin/pidginui.h	Wed Nov 01 01:43:05 2023 -0500
+++ b/pidgin/pidginui.h	Wed Nov 01 03:31:45 2023 -0500
@@ -56,7 +56,10 @@
  * Note: there's not much use for this outside of Pidgin's internal code.
  *
  * Returns: (transfer full): The new instance.
+ *
+ * Since: 3.0.0
  */
+PIDGIN_AVAILABLE_IN_3_0
 PurpleUi *pidgin_ui_new(void);
 
 G_END_DECLS

Mercurial Repository: pidgin3

mercurial