qulogic/pidgin

Make sure all of the roomlist API is marked with the proper version

8 months ago, Gary Kramlich
d1d0174ba72a
Parents ad55720b3b4d
Children 9acad6165ba9
Make sure all of the roomlist API is marked with the proper version

I compared these against a checkout of the v2.0.0 tag and using the girlint
stylesheet to verify.

Testing Done:
Asked the turtles for help.

Bugs closed: PIDGIN-17838

Reviewed at https://reviews.imfreedom.org/r/2723/
1 files changed, 37 insertions(+), 1 deletions(-)
  • +37 -1
    libpurple/roomlist.h
    • --- a/libpurple/roomlist.h Thu Oct 26 05:45:33 2023 -0500
    +++ b/libpurple/roomlist.h Thu Oct 26 05:47:48 2023 -0500
    @@ -46,6 +46,8 @@
    * this type.
    *
    * The types of fields.
    + *
    + * Since: 2.0.0
    */
    typedef enum
    {
    @@ -72,6 +74,8 @@
    * @add_room: Add a room to the list.
    *
    * The room list ops to be filled out by the UI.
    + *
    + * Since: 2.0.0
    */
    struct _PurpleRoomlistUiOps {
    void (*show_with_account)(PurpleAccount *account);
    @@ -90,6 +94,8 @@
    * PurpleRoomlist:
    *
    * Represents a list of rooms for a given connection on a given protocol.
    + *
    + * Since: 2.0.0
    */
    struct _PurpleRoomlist {
    GObject gparent;
    @@ -122,7 +128,10 @@
    * and pretend the user clicked the get list button.
    * While we're pretending, predend I didn't say anything about dialogs
    * or buttons, since this is the core.
    + *
    + * Since: 2.0.0
    */
    +PURPLE_AVAILABLE_IN_ALL
    void purple_roomlist_show_with_account(PurpleAccount *account);
    /**
    @@ -132,7 +141,10 @@
    * Returns a newly created room list object.
    *
    * Returns: The new room list handle.
    + *
    + * Since: 2.0.0
    */
    +PURPLE_AVAILABLE_IN_ALL
    PurpleRoomlist *purple_roomlist_new(PurpleAccount *account);
    /**
    @@ -158,7 +170,10 @@
    * Set the different field types and their names for this protocol.
    *
    * This must be called before purple_roomlist_room_add().
    + *
    + * Since: 2.0.0
    */
    +PURPLE_AVAILABLE_IN_ALL
    void purple_roomlist_set_fields(PurpleRoomlist *list, GList *fields);
    /**
    @@ -170,7 +185,10 @@
    *
    * The UI is encouraged to somehow hint to the user
    * whether or not we're busy downloading a room list or not.
    + *
    + * Since: 2.0.0
    */
    +PURPLE_AVAILABLE_IN_ALL
    void purple_roomlist_set_in_progress(PurpleRoomlist *list, gboolean in_progress);
    /**
    @@ -183,7 +201,10 @@
    * whether or not we're busy downloading a room list or not.
    *
    * Returns: True if we're downloading it, or false if we're not.
    + *
    + * Since: 2.0.0
    */
    +PURPLE_AVAILABLE_IN_ALL
    gboolean purple_roomlist_get_in_progress(PurpleRoomlist *list);
    /**
    @@ -193,7 +214,10 @@
    order as was given in purple_roomlist_set_fields().
    *
    * Adds a room to the list of them.
    -*/
    + *
    + * Since: 2.0.0
    + */
    +PURPLE_AVAILABLE_IN_ALL
    void purple_roomlist_room_add(PurpleRoomlist *list, PurpleRoomlistRoom *room);
    /**
    @@ -205,7 +229,10 @@
    *
    * Returns: (transfer full): A PurpleRoomlist* or %NULL if the protocol doesn't
    * support that.
    + *
    + * Since: 2.0.0
    */
    +PURPLE_AVAILABLE_IN_ALL
    PurpleRoomlist *purple_roomlist_get_list(PurpleConnection *gc);
    /**
    @@ -216,7 +243,10 @@
    * If this is possible and done, the protocol will
    * call set_in_progress with %FALSE and possibly
    * unref the list if it took a reference.
    + *
    + * Since: 2.0.0
    */
    +PURPLE_AVAILABLE_IN_ALL
    void purple_roomlist_cancel_get_list(PurpleRoomlist *list);
    /**
    @@ -252,7 +282,10 @@
    * @ops: The UI operations structure.
    *
    * Sets the UI operations structure to be used in all purple room lists.
    + *
    + * Since: 2.0.0
    */
    +PURPLE_AVAILABLE_IN_ALL
    void purple_roomlist_set_ui_ops(PurpleRoomlistUiOps *ops);
    /**
    @@ -262,7 +295,10 @@
    * new windows.
    *
    * Returns: A filled-out PurpleRoomlistUiOps structure.
    + *
    + * Since: 2.0.0
    */
    +PURPLE_AVAILABLE_IN_ALL
    PurpleRoomlistUiOps *purple_roomlist_get_ui_ops(void);
    G_END_DECLS