qulogic/pidgin

Add Since tags and visibility for Pidgin 2.x symbols

8 months ago, Elliott Sales de Andrade
5de142a471e0
Parents 2cde2ccea465
Children b7d530551c1b
Add Since tags and visibility for Pidgin 2.x symbols

Add Since tags and visibility for Pidgin 2.0.0 symbols

Testing Done:
Compiled.

Bugs closed: PIDGIN-17839

Reviewed at https://reviews.imfreedom.org/r/2762/
16 files changed, 168 insertions(+), 3 deletions(-)
  • +8 -0
    pidgin/gtkblist.h
  • +14 -0
    pidgin/gtkconv.h
  • +10 -0
    pidgin/gtkdialogs.h
  • +3 -0
    pidgin/gtkmedia.h
  • +11 -0
    pidgin/gtknotify.h
  • +5 -0
    pidgin/gtkrequest.h
  • +14 -0
    pidgin/gtkroomlist.h
  • +5 -0
    pidgin/gtksavedstatuses.h
  • +16 -0
    pidgin/gtkutils.h
  • +5 -0
    pidgin/gtkwhiteboard.h
  • +41 -0
    pidgin/gtkxfer.h
  • +3 -1
    pidgin/pidgincore.h
  • +15 -2
    pidgin/pidgindebug.h
  • +6 -0
    pidgin/pidginstatusbox.h
  • +4 -0
    pidgin/pidginversion.h
  • +8 -0
    pidgin/prefs/pidginprefs.h
    • --- a/pidgin/gtkblist.h Tue Oct 31 18:50:36 2023 -0500
    +++ b/pidgin/gtkblist.h Wed Nov 01 00:17:57 2023 -0500
    @@ -28,6 +28,8 @@
    #include <purple.h>
    +#include "pidginversion.h"
    +
    #define PIDGIN_TYPE_BUDDY_LIST (pidgin_buddy_list_get_type())
    typedef struct _PidginBuddyList PidginBuddyList;
    @@ -60,14 +62,20 @@
    *
    * Returns: Returns TRUE if there are accounts online capable of
    * joining chat rooms. Otherwise returns FALSE.
    + *
    + * Since: 2.0.0
    */
    +PIDGIN_AVAILABLE_IN_ALL
    gboolean pidgin_blist_joinchat_is_showable(void);
    /**
    * pidgin_blist_joinchat_show:
    *
    * Shows the join chat dialog.
    + *
    + * Since: 2.0.0
    */
    +PIDGIN_AVAILABLE_IN_ALL
    void pidgin_blist_joinchat_show(void);
    G_END_DECLS
    --- a/pidgin/gtkconv.h Tue Oct 31 18:50:36 2023 -0500
    +++ b/pidgin/gtkconv.h Wed Nov 01 00:17:57 2023 -0500
    @@ -39,6 +39,8 @@
    #include <purple.h>
    +#include "pidginversion.h"
    +
    /**************************************************************************
    * Structures
    **************************************************************************/
    @@ -76,7 +78,10 @@
    * Returns the UI operations structure for GTK conversations.
    *
    * Returns: The GTK conversation operations structure.
    + *
    + * Since: 2.0.0
    */
    +PIDGIN_AVAILABLE_IN_ALL
    PurpleConversationUiOps *pidgin_conversations_get_conv_ui_ops(void);
    /**************************************************************************/
    @@ -89,21 +94,30 @@
    * Returns the gtk conversations subsystem handle.
    *
    * Returns: The conversations subsystem handle.
    + *
    + * Since: 2.0.0
    */
    +PIDGIN_AVAILABLE_IN_ALL
    void *pidgin_conversations_get_handle(void);
    /**
    * pidgin_conversations_init:
    *
    * Initializes the GTK conversations subsystem.
    + *
    + * Since: 2.0.0
    */
    +PIDGIN_AVAILABLE_IN_ALL
    void pidgin_conversations_init(void);
    /**
    * pidgin_conversations_uninit:
    *
    * Uninitialized the GTK conversation subsystem.
    + *
    + * Since: 2.0.0
    */
    +PIDGIN_AVAILABLE_IN_ALL
    void pidgin_conversations_uninit(void);
    G_END_DECLS
    --- a/pidgin/gtkdialogs.h Tue Oct 31 18:50:36 2023 -0500
    +++ b/pidgin/gtkdialogs.h Wed Nov 01 00:17:57 2023 -0500
    @@ -28,13 +28,23 @@
    #include <purple.h>
    +#include "pidginversion.h"
    +
    G_BEGIN_DECLS
    +PIDGIN_AVAILABLE_IN_ALL
    void pidgin_dialogs_im(void);
    +
    +PIDGIN_AVAILABLE_IN_ALL
    void pidgin_dialogs_im_with_user(PurpleAccount *account, const char *username);
    +
    +PIDGIN_AVAILABLE_IN_ALL
    void pidgin_dialogs_info(void);
    +PIDGIN_AVAILABLE_IN_ALL
    void pidgin_dialogs_alias_buddy(PurpleBuddy *buddy);
    +
    +PIDGIN_AVAILABLE_IN_ALL
    void pidgin_dialogs_alias_chat(PurpleChat *chat);
    G_END_DECLS
    --- a/pidgin/gtkmedia.h Tue Oct 31 18:50:36 2023 -0500
    +++ b/pidgin/gtkmedia.h Wed Nov 01 00:17:57 2023 -0500
    @@ -26,8 +26,11 @@
    #ifndef PIDGIN_MEDIA_H
    #define PIDGIN_MEDIA_H
    +#include "pidginversion.h"
    +
    G_BEGIN_DECLS
    +PURPLE_AVAILABLE_IN_2_6
    void pidgin_medias_init(void);
    G_END_DECLS
    --- a/pidgin/gtknotify.h Tue Oct 31 18:50:36 2023 -0500
    +++ b/pidgin/gtknotify.h Wed Nov 01 00:17:57 2023 -0500
    @@ -28,6 +28,8 @@
    #include <purple.h>
    +#include "pidginversion.h"
    +
    G_BEGIN_DECLS
    /**
    @@ -36,21 +38,30 @@
    * Returns the UI operations structure for GTK notification functions.
    *
    * Returns: The GTK UI notify operations structure.
    + *
    + * Since: 2.0.0
    */
    +PIDGIN_AVAILABLE_IN_ALL
    PurpleNotifyUiOps *pidgin_notify_get_ui_ops(void);
    /**
    * pidgin_notify_init:
    *
    * Initializes the GTK notifications subsystem.
    + *
    + * Since: 2.6.0
    */
    +PIDGIN_AVAILABLE_IN_2_6
    void pidgin_notify_init(void);
    /**
    * pidgin_notify_uninit:
    *
    * Uninitialized the GTK notifications subsystem.
    + *
    + * Since: 2.6.0
    */
    +PIDGIN_AVAILABLE_IN_2_6
    void pidgin_notify_uninit(void);
    G_END_DECLS
    --- a/pidgin/gtkrequest.h Tue Oct 31 18:50:36 2023 -0500
    +++ b/pidgin/gtkrequest.h Wed Nov 01 00:17:57 2023 -0500
    @@ -30,6 +30,8 @@
    #include <purple.h>
    +#include "pidginversion.h"
    +
    G_BEGIN_DECLS
    /**
    @@ -38,7 +40,10 @@
    * Returns the UI operations structure for GTK request functions.
    *
    * Returns: The GTK UI request operations structure.
    + *
    + * Since: 2.0.0
    */
    +PIDGIN_AVAILABLE_IN_ALL
    PurpleRequestUiOps *pidgin_request_get_ui_ops(void);
    /**
    --- a/pidgin/gtkroomlist.h Tue Oct 31 18:50:36 2023 -0500
    +++ b/pidgin/gtkroomlist.h Wed Nov 01 00:17:57 2023 -0500
    @@ -28,13 +28,18 @@
    #include <purple.h>
    +#include "pidginversion.h"
    +
    G_BEGIN_DECLS
    /**
    * pidgin_roomlist_init:
    *
    * Initializes the room list subsystem.
    + *
    + * Since: 2.0.0
    */
    +PIDGIN_AVAILABLE_IN_ALL
    void pidgin_roomlist_init(void);
    /**
    @@ -44,14 +49,20 @@
    *
    * Returns: TRUE if there are accounts online that support listing
    * chat rooms. Otherwise return FALSE.
    + *
    + * Since: 2.0.0
    */
    +PIDGIN_AVAILABLE_IN_ALL
    gboolean pidgin_roomlist_is_showable(void);
    /**
    * pidgin_roomlist_dialog_show:
    *
    * Shows a new roomlist dialog.
    + *
    + * Since: 2.0.0
    */
    +PIDGIN_AVAILABLE_IN_ALL
    void pidgin_roomlist_dialog_show(void);
    /**
    @@ -59,7 +70,10 @@
    * @account: The account to use.
    *
    * Shows a new room list dialog and fetches the list for the specified account.
    + *
    + * Since: 2.0.0
    */
    +PIDGIN_AVAILABLE_IN_ALL
    void pidgin_roomlist_dialog_show_with_account(PurpleAccount *account);
    G_END_DECLS
    --- a/pidgin/gtksavedstatuses.h Tue Oct 31 18:50:36 2023 -0500
    +++ b/pidgin/gtksavedstatuses.h Wed Nov 01 00:17:57 2023 -0500
    @@ -28,6 +28,8 @@
    #include <purple.h>
    +#include "pidginversion.h"
    +
    G_BEGIN_DECLS
    /**
    @@ -39,7 +41,10 @@
    * when one is selected
    *
    * Returns: (transfer full): The menu widget
    + *
    + * Since: 2.0.0
    */
    +PIDGIN_AVAILABLE_IN_ALL
    GtkWidget *pidgin_status_menu(PurpleSavedStatus *status, GCallback callback);
    G_END_DECLS
    --- a/pidgin/gtkutils.h Tue Oct 31 18:50:36 2023 -0500
    +++ b/pidgin/gtkutils.h Wed Nov 01 00:17:57 2023 -0500
    @@ -32,11 +32,13 @@
    #include "pidginversion.h"
    +PIDGIN_AVAILABLE_TYPE_IN_2_1
    typedef struct {
    gboolean is_buddy;
    PurpleBuddy *buddy;
    } PidginBuddyCompletionEntry;
    +PIDGIN_AVAILABLE_TYPE_IN_2_1
    typedef gboolean (*PidginFilterBuddyCompletionEntryFunc) (const PidginBuddyCompletionEntry *completion_entry, gpointer user_data);
    @@ -50,7 +52,10 @@
    * Creates a HIG preferences frame.
    *
    * Returns: (transfer full): The vbox to put things into.
    + *
    + * Since: 2.0.0
    */
    +PIDGIN_AVAILABLE_IN_ALL
    GtkWidget *pidgin_make_frame(GtkWidget *parent, const char *title);
    /**
    @@ -65,7 +70,10 @@
    *
    * Add autocompletion of screenames to an entry, supporting a filtering
    * function.
    + *
    + * Since: 2.0.0
    */
    +PIDGIN_AVAILABLE_IN_ALL
    void pidgin_setup_screenname_autocomplete(
    GtkWidget *entry, GtkWidget *chooser,
    PidginFilterBuddyCompletionEntryFunc filter_func, gpointer user_data);
    @@ -79,7 +87,10 @@
    * The default filter function for username autocomplete.
    *
    * Returns: Returns %TRUE if the autocompletion entry is filtered.
    + *
    + * Since: 2.1.0
    */
    +PIDGIN_AVAILABLE_IN_2_1
    gboolean pidgin_screenname_autocomplete_default_filter(const PidginBuddyCompletionEntry *completion_entry, gpointer all_accounts);
    /**
    @@ -114,7 +125,10 @@
    *
    * Sets an ATK name for a given widget. Also sets the labelled-by
    * and label-for ATK relationships.
    + *
    + * Since: 2.0.0
    */
    +PIDGIN_AVAILABLE_IN_ALL
    void pidgin_set_accessible_label(GtkWidget *w, GtkLabel *l);
    /**
    @@ -126,7 +140,9 @@
    * pidgin_tree_view_search_equal_func,
    * search_data, search_data_destroy_cb);
    *
    + * Since: 2.0.0
    */
    +PIDGIN_AVAILABLE_IN_ALL
    gboolean pidgin_tree_view_search_equal_func(GtkTreeModel *model, gint column,
    const gchar *key, GtkTreeIter *iter, gpointer data);
    --- a/pidgin/gtkwhiteboard.h Tue Oct 31 18:50:36 2023 -0500
    +++ b/pidgin/gtkwhiteboard.h Wed Nov 01 00:17:57 2023 -0500
    @@ -26,6 +26,8 @@
    #ifndef _PIDGINWHITEBOARD_H_
    #define _PIDGINWHITEBOARD_H_
    +#include "pidginversion.h"
    +
    G_BEGIN_DECLS
    /*****************************************************************************/
    @@ -38,7 +40,10 @@
    * Gets the GtkWhiteboard UI Operations.
    *
    * Returns: The GtkWhiteboard UI Operations.
    + *
    + * Since: 2.0.0
    */
    +PIDGIN_AVAILABLE_IN_ALL
    PurpleWhiteboardUiOps *pidgin_whiteboard_get_ui_ops(void);
    G_END_DECLS
    --- a/pidgin/gtkxfer.h Tue Oct 31 18:50:36 2023 -0500
    +++ b/pidgin/gtkxfer.h Wed Nov 01 00:17:57 2023 -0500
    @@ -28,6 +28,8 @@
    #include <purple.h>
    +#include "pidginversion.h"
    +
    G_BEGIN_DECLS
    /**
    @@ -52,7 +54,10 @@
    * Creates a new file transfer dialog.
    *
    * Returns: The new dialog.
    + *
    + * Since: 2.0.0
    */
    +PIDGIN_AVAILABLE_IN_ALL
    PidginXferDialog *pidgin_xfer_dialog_new(void);
    /**
    @@ -60,7 +65,10 @@
    * @dialog: The file transfer dialog.
    *
    * Destroys a file transfer dialog.
    + *
    + * Since: 2.0.0
    */
    +PIDGIN_AVAILABLE_IN_ALL
    void pidgin_xfer_dialog_destroy(PidginXferDialog *dialog);
    /**
    @@ -69,7 +77,10 @@
    *
    * Displays the file transfer dialog given.
    * If dialog is %NULL, displays the default dialog, creating one if necessary
    + *
    + * Since: 2.0.0
    */
    +PIDGIN_AVAILABLE_IN_ALL
    void pidgin_xfer_dialog_show(PidginXferDialog *dialog);
    /**
    @@ -77,7 +88,10 @@
    * @dialog: The file transfer dialog to hide.
    *
    * Hides the file transfer dialog.
    + *
    + * Since: 2.0.0
    */
    +PIDGIN_AVAILABLE_IN_ALL
    void pidgin_xfer_dialog_hide(PidginXferDialog *dialog);
    /**
    @@ -86,7 +100,10 @@
    * @xfer: The file transfer.
    *
    * Adds a file transfer to the dialog.
    + *
    + * Since: 2.0.0
    */
    +PIDGIN_AVAILABLE_IN_ALL
    void pidgin_xfer_dialog_add_xfer(PidginXferDialog *dialog, PurpleXfer *xfer);
    /**
    @@ -95,7 +112,10 @@
    * @xfer: The file transfer.
    *
    * Removes a file transfer from the dialog.
    + *
    + * Since: 2.0.0
    */
    +PIDGIN_AVAILABLE_IN_ALL
    void pidgin_xfer_dialog_remove_xfer(PidginXferDialog *dialog,
    PurpleXfer *xfer);
    @@ -105,7 +125,10 @@
    * @xfer: The file transfer that was cancelled.
    *
    * Indicate in a file transfer dialog that a transfer was cancelled.
    + *
    + * Since: 2.0.0
    */
    +PIDGIN_AVAILABLE_IN_ALL
    void pidgin_xfer_dialog_cancel_xfer(PidginXferDialog *dialog,
    PurpleXfer *xfer);
    @@ -115,7 +138,10 @@
    * @xfer: The file transfer.
    *
    * Updates the information for a transfer in the dialog.
    + *
    + * Since: 2.0.0
    */
    +PIDGIN_AVAILABLE_IN_ALL
    void pidgin_xfer_dialog_update_xfer(PidginXferDialog *dialog,
    PurpleXfer *xfer);
    @@ -127,14 +153,20 @@
    * pidgin_xfers_init:
    *
    * Initializes the GTK file transfer system.
    + *
    + * Since: 2.0.0
    */
    +PIDGIN_AVAILABLE_IN_ALL
    void pidgin_xfers_init(void);
    /**
    * pidgin_xfers_uninit:
    *
    * Uninitializes the GTK file transfer system.
    + *
    + * Since: 2.0.0
    */
    +PIDGIN_AVAILABLE_IN_ALL
    void pidgin_xfers_uninit(void);
    /**
    @@ -142,7 +174,10 @@
    * @dialog: The main dialog.
    *
    * Sets pidgin's main file transfer dialog.
    + *
    + * Since: 2.0.0
    */
    +PIDGIN_AVAILABLE_IN_ALL
    void pidgin_set_xfer_dialog(PidginXferDialog *dialog);
    /**
    @@ -151,7 +186,10 @@
    * Returns pirgin's main file transfer dialog.
    *
    * Returns: (transfer none): The main dialog.
    + *
    + * Since: 2.0.0
    */
    +PIDGIN_AVAILABLE_IN_ALL
    PidginXferDialog *pidgin_get_xfer_dialog(void);
    /**
    @@ -160,7 +198,10 @@
    * Returns the UI operations structure for the GTK file transfer UI.
    *
    * Returns: The GTK file transfer UI operations structure.
    + *
    + * Since: 2.0.0
    */
    +PIDGIN_AVAILABLE_IN_ALL
    PurpleXferUiOps *pidgin_xfers_get_ui_ops(void);
    G_END_DECLS
    --- a/pidgin/pidgincore.h Tue Oct 31 18:50:36 2023 -0500
    +++ b/pidgin/pidgincore.h Wed Nov 01 00:17:57 2023 -0500
    @@ -30,6 +30,8 @@
    #include <purple.h>
    +#include "pidginversion.h"
    +
    #ifdef _WIN32
    # include "win32/gtkwin32dep.h"
    #endif
    @@ -39,7 +41,7 @@
    /* Translators may want to transliterate the name.
    It is not to be translated. */
    -#define PIDGIN_NAME _("Pidgin")
    +#define PIDGIN_NAME _("Pidgin") PIDGIN_AVAILABLE_MACRO_IN_2_1
    /**
    * PIDGIN_ALERT_TITLE:
    --- a/pidgin/pidgindebug.h Tue Oct 31 18:50:36 2023 -0500
    +++ b/pidgin/pidgindebug.h Wed Nov 01 00:17:57 2023 -0500
    @@ -28,6 +28,8 @@
    #include <purple.h>
    +#include "pidginversion.h"
    +
    G_BEGIN_DECLS
    #define PIDGIN_TYPE_DEBUG_WINDOW (pidgin_debug_window_get_type())
    @@ -61,8 +63,9 @@
    *
    * Perform necessary initializations.
    *
    - * Since: 3.0.0
    + * Since: 2.0.0
    */
    +PIDGIN_AVAILABLE_IN_ALL
    void pidgin_debug_init(void);
    /**
    @@ -70,8 +73,9 @@
    *
    * Perform necessary uninitializations.
    *
    - * Since: 3.0.0
    + * Since: 2.0.0
    */
    +PIDGIN_AVAILABLE_IN_ALL
    void pidgin_debug_uninit(void);
    /**
    @@ -80,21 +84,30 @@
    * Get the handle for the GTK debug system.
    *
    * Returns: the handle to the debug system
    + *
    + * Since: 2.0.0
    */
    +PIDGIN_AVAILABLE_IN_ALL
    void *pidgin_debug_get_handle(void);
    /**
    * pidgin_debug_window_show:
    *
    * Shows the debug window.
    + *
    + * Since: 2.0.0
    */
    +PIDGIN_AVAILABLE_IN_ALL
    void pidgin_debug_window_show(void);
    /**
    * pidgin_debug_window_hide:
    *
    * Hides the debug window.
    + *
    + * Since: 2.0.0
    */
    +PIDGIN_AVAILABLE_IN_ALL
    void pidgin_debug_window_hide(void);
    G_END_DECLS
    --- a/pidgin/pidginstatusbox.h Tue Oct 31 18:50:36 2023 -0500
    +++ b/pidgin/pidginstatusbox.h Wed Nov 01 00:17:57 2023 -0500
    @@ -29,12 +29,18 @@
    #include <gtk/gtk.h>
    +#include "pidginversion.h"
    +
    G_BEGIN_DECLS
    #define PIDGIN_TYPE_STATUS_BOX (pidgin_status_box_get_type ())
    +
    +PIDGIN_AVAILABLE_IN_ALL
    G_DECLARE_FINAL_TYPE(PidginStatusBox, pidgin_status_box, PIDGIN, STATUS_BOX,
    GtkBox)
    +
    +PIDGIN_AVAILABLE_IN_ALL
    GtkWidget *pidgin_status_box_new(void);
    G_END_DECLS
    --- a/pidgin/pidginversion.h Tue Oct 31 18:50:36 2023 -0500
    +++ b/pidgin/pidginversion.h Wed Nov 01 00:17:57 2023 -0500
    @@ -133,8 +133,12 @@
    #if PIDGIN_VERSION_MAX_ALLOWED < PIDGIN_VERSION_2_1
    #define PIDGIN_AVAILABLE_IN_2_1 PIDGIN_UNAVAILABLE(2, 1)
    +#define PIDGIN_AVAILABLE_MACRO_IN_2_1 PIDGIN_UNAVAILABLE_MACRO(2, 1)
    +#define PIDGIN_AVAILABLE_TYPE_IN_2_1 PIDGIN_UNAVAILABLE_TYPE(2, 1)
    #else
    #define PIDGIN_AVAILABLE_IN_2_1 _PIDGIN_EXTERN
    +#define PIDGIN_AVAILABLE_MACRO_IN_2_1
    +#define PIDGIN_AVAILABLE_TYPE_IN_2_1
    #endif
    /**
    --- a/pidgin/prefs/pidginprefs.h Tue Oct 31 18:50:36 2023 -0500
    +++ b/pidgin/prefs/pidginprefs.h Wed Nov 01 00:17:57 2023 -0500
    @@ -31,6 +31,8 @@
    #include <purple.h>
    #include <gtk/gtk.h>
    +#include "pidginversion.h"
    +
    G_BEGIN_DECLS
    #define PIDGIN_TYPE_PREFS_WINDOW (pidgin_prefs_window_get_type())
    @@ -41,14 +43,20 @@
    * pidgin_prefs_init:
    *
    * Initializes all UI-specific preferences.
    + *
    + * Since: 2.0.0
    */
    +PIDGIN_AVAILABLE_IN_ALL
    void pidgin_prefs_init(void);
    /**
    * pidgin_prefs_update_old:
    *
    * Rename legacy prefs and delete some that no longer exist.
    + *
    + * Since: 2.0.0
    */
    +PIDGIN_AVAILABLE_IN_ALL
    void pidgin_prefs_update_old(void);
    G_END_DECLS