qulogic/pidgin

Add Since and symbol visibility on remaining Pidgin API

6 months ago, Elliott Sales de Andrade
2b1d9d0770f2
Parents ca3374c1cdba
Children 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/
--- 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