GNOME.org
 

[gnome-builder] libide-core: update notifications availability

commit 29952788e3a14adb2005425f328e5e0b26f13594
Author: Christian Hergert <chergert redhat com>
Date:   Mon Jul 11 16:33:32 2022 -0700

    libide-core: update notifications availability

 src/libide/core/ide-notification.c  | 58 -------------------------------
 src/libide/core/ide-notification.h  | 68 ++++++++++++++++++-------------------
 src/libide/core/ide-notifications.c | 18 ----------
 src/libide/core/ide-notifications.h | 14 ++++----
 4 files changed, 41 insertions(+), 117 deletions(-)
---
diff --git a/src/libide/core/ide-notification.c b/src/libide/core/ide-notification.c
index 4888c0e34..ab1fa943b 100644
--- a/src/libide/core/ide-notification.c
+++ b/src/libide/core/ide-notification.c
@@ -228,8 +228,6 @@ ide_notification_class_init (IdeNotificationClass *klass)
    *
    * The "body" property is the main body of text for the notification.
    * Not all notifications need this, but more complex notifications might.
-   *
-   * Since: 3.32
    */
   properties [PROP_BODY] =
     g_param_spec_string ("body",
@@ -243,8 +241,6 @@ ide_notification_class_init (IdeNotificationClass *klass)
    *
    * The "has-progress" property denotes the notification will receive
    * updates to the #IdeNotification:progress property.
-   *
-   * Since: 3.32
    */
   properties [PROP_HAS_PROGRESS] =
     g_param_spec_boolean ("has-progress",
@@ -258,8 +254,6 @@ ide_notification_class_init (IdeNotificationClass *klass)
    *
    * The "icon" property is an optional icon that may be shown next to
    * the notification title and body under certain senarios.
-   *
-   * Since: 3.32
    */
   properties [PROP_ICON] =
     g_param_spec_object ("icon",
@@ -273,8 +267,6 @@ ide_notification_class_init (IdeNotificationClass *klass)
    *
    * The "icon-name" property is a helper to make setting #IdeNotification:icon
    * more convenient.
-   *
-   * Since: 3.32
    */
   properties [PROP_ICON_NAME] =
     g_param_spec_string ("icon-name",
@@ -288,8 +280,6 @@ ide_notification_class_init (IdeNotificationClass *klass)
    *
    * The "id" property is an optional identifier that can be used to locate
    * the notification later.
-   *
-   * Since: 3.32
    */
   properties [PROP_ID] =
     g_param_spec_string ("id",
@@ -306,8 +296,6 @@ ide_notification_class_init (IdeNotificationClass *klass)
    *
    * You may also use the #IdeNotification:urgent property to raise the
    * importance of a message to the user.
-   *
-   * Since: 3.32
    */
   properties [PROP_PRIORITY] =
     g_param_spec_int ("priority",
@@ -323,8 +311,6 @@ ide_notification_class_init (IdeNotificationClass *klass)
    * the operation for which the notification represents.
    *
    * This property is ignored if #IdeNotification:has-progress is unset.
-   *
-   * Since: 3.32
    */
   properties [PROP_PROGRESS] =
     g_param_spec_double ("progress",
@@ -340,8 +326,6 @@ ide_notification_class_init (IdeNotificationClass *klass)
    * progress, but it is imprecise.
    *
    * The UI may show a bouncing progress bar if set.
-   *
-   * Since: 3.32
    */
   properties [PROP_PROGRESS_IS_IMPRECISE] =
     g_param_spec_boolean ("progress-is-imprecise",
@@ -355,8 +339,6 @@ ide_notification_class_init (IdeNotificationClass *klass)
    *
    * The "title" property is the main text to show the user. It may be
    * displayed more prominently such as in the titlebar.
-   *
-   * Since: 3.32
    */
   properties [PROP_TITLE] =
     g_param_spec_string ("title",
@@ -370,8 +352,6 @@ ide_notification_class_init (IdeNotificationClass *klass)
    *
    * If the notification is urgent. These notifications will be displayed with
    * higher priority than those without the urgent property set.
-   *
-   * Since: 3.32
    */
   properties [PROP_URGENT] =
     g_param_spec_boolean ("urgent",
@@ -403,8 +383,6 @@ ide_notification_init (IdeNotification *self)
  * setup_notification (notify);
  * ide_notification_attach (notif, IDE_OBJECT (some_object));
  * ```
- *
- * Since: 3.32
  */
 IdeNotification *
 ide_notification_new (void)
@@ -419,8 +397,6 @@ ide_notification_new (void)
  *
  * This function will locate the #IdeNotifications object starting from
  * @object and attach @self as a child to that object.
- *
- * Since: 3.32
  */
 void
 ide_notification_attach (IdeNotification *self,
@@ -446,8 +422,6 @@ ide_notification_attach (IdeNotification *self,
  *
  * Copies the id of the notification and returns it to the caller after locking
  * the object. A copy is used to avoid thread-races.
- *
- * Since: 3.32
  */
 gchar *
 ide_notification_dup_id (IdeNotification *self)
@@ -470,8 +444,6 @@ ide_notification_dup_id (IdeNotification *self)
  * @id: (nullable): a string containing the id, or %NULL
  *
  * Sets the #IdeNotification:id property.
- *
- * Since: 3.32
  */
 void
 ide_notification_set_id (IdeNotification *self,
@@ -496,8 +468,6 @@ ide_notification_set_id (IdeNotification *self,
  *
  * Copies the current title and returns it to the caller after locking the
  * object. A copy is used to avoid thread-races.
- *
- * Since: 3.32
  */
 gchar *
 ide_notification_dup_title (IdeNotification *self)
@@ -520,8 +490,6 @@ ide_notification_dup_title (IdeNotification *self)
  * @title: (nullable): a string containing the title text, or %NULL
  *
  * Sets the #IdeNotification:title property.
- *
- * Since: 3.32
  */
 void
 ide_notification_set_title (IdeNotification *self,
@@ -546,8 +514,6 @@ ide_notification_set_title (IdeNotification *self,
  *
  * Copies the current body and returns it to the caller after locking the
  * object. A copy is used to avoid thread-races.
- *
- * Since: 3.32
  */
 gchar *
 ide_notification_dup_body (IdeNotification *self)
@@ -570,8 +536,6 @@ ide_notification_dup_body (IdeNotification *self)
  * @body: (nullable): a string containing the body text, or %NULL
  *
  * Sets the #IdeNotification:body property.
- *
- * Since: 3.32
  */
 void
 ide_notification_set_body (IdeNotification *self,
@@ -598,8 +562,6 @@ ide_notification_set_body (IdeNotification *self,
  * to the #GIcon.
  *
  * Returns: (transfer full) (nullable): a #GIcon or %NULL
- *
- * Since: 3.32
  */
 GIcon *
 ide_notification_ref_icon (IdeNotification *self)
@@ -749,8 +711,6 @@ ide_notification_get_n_buttons (IdeNotification *self)
  * and ide_object_unlock().
  *
  * Returns: %TRUE if @button was found; otherwise %FALSE
- *
- * Since: 3.32
  */
 gboolean
 ide_notification_get_button (IdeNotification  *self,
@@ -798,8 +758,6 @@ ide_notification_get_button (IdeNotification  *self,
  * Adds a new button that may be displayed with the notification.
  *
  * See also: ide_notification_add_button_with_target_value().
- *
- * Since: 3.32
  */
 void
 ide_notification_add_button (IdeNotification *self,
@@ -832,8 +790,6 @@ ide_notification_add_button (IdeNotification *self,
  *
  * Adds a new button, used the parsed #GVariant format for the action
  * target.
- *
- * Since: 3.32
  */
 void
 ide_notification_add_button_with_target_value (IdeNotification *self,
@@ -965,8 +921,6 @@ ide_notification_compare (IdeNotification *a,
  * Gets the progress for the notification.
  *
  * Returns: a value between 0.0 and 1.0
- *
- * Since: 3.32
  */
 gdouble
 ide_notification_get_progress (IdeNotification *self)
@@ -989,8 +943,6 @@ ide_notification_get_progress (IdeNotification *self)
  * @progress: a value between 0.0 and 1.0
  *
  * Sets the progress for the notification.
- *
- * Since: 3.32
  */
 void
 ide_notification_set_progress (IdeNotification *self,
@@ -1018,8 +970,6 @@ ide_notification_set_progress (IdeNotification *self,
  * Gets if the notification supports progress updates.
  *
  * Returns: %TRUE if progress updates are supported.
- *
- * Since: 3.32
  */
 gboolean
 ide_notification_get_has_progress (IdeNotification *self)
@@ -1042,8 +992,6 @@ ide_notification_get_has_progress (IdeNotification *self)
  * @has_progress: if @notification supports progress
  *
  * Set to %TRUE if the notification supports progress updates.
- *
- * Since: 3.32
  */
 void
 ide_notification_set_has_progress (IdeNotification *self,
@@ -1104,8 +1052,6 @@ ide_notification_set_progress_is_imprecise (IdeNotification *self,
  *
  * Withdraws the notification by removing it from the #IdeObject parent it
  * belongs to.
- *
- * Since: 3.32
  */
 void
 ide_notification_withdraw (IdeNotification *self)
@@ -1138,8 +1084,6 @@ do_withdrawal (gpointer data)
  *   sensible default.
  *
  * Withdraws @self from it's #IdeObject parent after @seconds have passed.
- *
- * Since: 3.32
  */
 void
 ide_notification_withdraw_in_seconds (IdeNotification *self,
@@ -1165,8 +1109,6 @@ ide_notification_withdraw_in_seconds (IdeNotification *self,
  *
  * Remember to make sure to unref the #IdeNotification instance with
  * g_object_unref() during the #GDestroyNotify.
- *
- * Since: 3.32
  */
 void
 ide_notification_file_progress_callback (goffset  current_num_bytes,
diff --git a/src/libide/core/ide-notification.h b/src/libide/core/ide-notification.h
index fdb763a67..07b58d785 100644
--- a/src/libide/core/ide-notification.h
+++ b/src/libide/core/ide-notification.h
@@ -26,7 +26,7 @@ G_BEGIN_DECLS
 
 #define IDE_TYPE_NOTIFICATION (ide_notification_get_type())
 
-IDE_AVAILABLE_IN_3_32
+IDE_AVAILABLE_IN_ALL
 G_DECLARE_DERIVABLE_TYPE (IdeNotification, ide_notification, IDE, NOTIFICATION, IdeObject)
 
 struct _IdeNotificationClass
@@ -37,103 +37,103 @@ struct _IdeNotificationClass
   gpointer _reserved[16];
 };
 
-IDE_AVAILABLE_IN_3_32
+IDE_AVAILABLE_IN_ALL
 IdeNotification *ide_notification_new                                 (void);
-IDE_AVAILABLE_IN_3_32
+IDE_AVAILABLE_IN_ALL
 void             ide_notification_attach                              (IdeNotification  *self,
                                                                        IdeObject        *object);
-IDE_AVAILABLE_IN_3_32
+IDE_AVAILABLE_IN_ALL
 gchar           *ide_notification_dup_id                              (IdeNotification  *self);
-IDE_AVAILABLE_IN_3_32
+IDE_AVAILABLE_IN_ALL
 void             ide_notification_set_id                              (IdeNotification  *self,
                                                                        const gchar      *id);
-IDE_AVAILABLE_IN_3_32
+IDE_AVAILABLE_IN_ALL
 gchar           *ide_notification_dup_title                           (IdeNotification  *self);
-IDE_AVAILABLE_IN_3_32
+IDE_AVAILABLE_IN_ALL
 void             ide_notification_set_title                           (IdeNotification  *self,
                                                                        const gchar      *title);
-IDE_AVAILABLE_IN_3_32
+IDE_AVAILABLE_IN_ALL
 GIcon           *ide_notification_ref_icon                            (IdeNotification  *self);
-IDE_AVAILABLE_IN_3_32
+IDE_AVAILABLE_IN_ALL
 void             ide_notification_set_icon                            (IdeNotification  *self,
                                                                        GIcon            *icon);
-IDE_AVAILABLE_IN_3_32
+IDE_AVAILABLE_IN_ALL
 void             ide_notification_set_icon_name                       (IdeNotification  *self,
                                                                        const gchar      *icon_name);
-IDE_AVAILABLE_IN_3_32
+IDE_AVAILABLE_IN_ALL
 gchar           *ide_notification_dup_body                            (IdeNotification  *self);
-IDE_AVAILABLE_IN_3_32
+IDE_AVAILABLE_IN_ALL
 void             ide_notification_set_body                            (IdeNotification  *self,
                                                                        const gchar      *body);
-IDE_AVAILABLE_IN_3_32
+IDE_AVAILABLE_IN_ALL
 gboolean         ide_notification_get_has_progress                    (IdeNotification  *self);
-IDE_AVAILABLE_IN_3_32
+IDE_AVAILABLE_IN_ALL
 void             ide_notification_set_has_progress                    (IdeNotification  *self,
                                                                        gboolean          has_progress);
-IDE_AVAILABLE_IN_3_32
+IDE_AVAILABLE_IN_ALL
 gint             ide_notification_get_priority                        (IdeNotification  *self);
-IDE_AVAILABLE_IN_3_32
+IDE_AVAILABLE_IN_ALL
 void             ide_notification_set_priority                        (IdeNotification  *self,
                                                                        gint              priority);
-IDE_AVAILABLE_IN_3_32
+IDE_AVAILABLE_IN_ALL
 gdouble          ide_notification_get_progress                        (IdeNotification  *self);
-IDE_AVAILABLE_IN_3_32
+IDE_AVAILABLE_IN_ALL
 void             ide_notification_set_progress                        (IdeNotification  *self,
                                                                        gdouble           progress);
-IDE_AVAILABLE_IN_3_32
+IDE_AVAILABLE_IN_ALL
 gboolean         ide_notification_get_progress_is_imprecise           (IdeNotification  *self);
-IDE_AVAILABLE_IN_3_32
+IDE_AVAILABLE_IN_ALL
 void             ide_notification_set_progress_is_imprecise           (IdeNotification  *self,
                                                                        gboolean          
progress_is_imprecise);
-IDE_AVAILABLE_IN_3_32
+IDE_AVAILABLE_IN_ALL
 gboolean         ide_notification_get_urgent                          (IdeNotification  *self);
-IDE_AVAILABLE_IN_3_32
+IDE_AVAILABLE_IN_ALL
 void             ide_notification_set_urgent                          (IdeNotification  *self,
                                                                        gboolean          urgent);
-IDE_AVAILABLE_IN_3_32
+IDE_AVAILABLE_IN_ALL
 guint            ide_notification_get_n_buttons                       (IdeNotification  *self);
-IDE_AVAILABLE_IN_3_32
+IDE_AVAILABLE_IN_ALL
 gboolean         ide_notification_get_button                          (IdeNotification  *self,
                                                                        guint             button,
                                                                        gchar           **label,
                                                                        GIcon           **icon,
                                                                        gchar           **action,
                                                                        GVariant        **target);
-IDE_AVAILABLE_IN_3_32
+IDE_AVAILABLE_IN_ALL
 void             ide_notification_add_button                          (IdeNotification  *self,
                                                                        const gchar      *label,
                                                                        GIcon            *icon,
                                                                        const gchar      *detailed_action);
-IDE_AVAILABLE_IN_3_32
+IDE_AVAILABLE_IN_ALL
 void             ide_notification_add_button_with_target_value        (IdeNotification  *self,
                                                                        const gchar      *label,
                                                                        GIcon            *icon,
                                                                        const gchar      *action,
                                                                        GVariant         *target);
-IDE_AVAILABLE_IN_3_32
+IDE_AVAILABLE_IN_ALL
 gboolean         ide_notification_get_default_action                  (IdeNotification  *self,
                                                                        gchar           **action,
                                                                        GVariant        **target);
-IDE_AVAILABLE_IN_3_32
+IDE_AVAILABLE_IN_ALL
 void             ide_notification_set_default_action                  (IdeNotification  *self,
                                                                        const gchar      *detailed_action);
-IDE_AVAILABLE_IN_3_32
+IDE_AVAILABLE_IN_ALL
 void             ide_notification_set_default_action_and_target_value (IdeNotification  *self,
                                                                        const gchar      *action,
                                                                        GVariant         *target);
-IDE_AVAILABLE_IN_3_32
+IDE_AVAILABLE_IN_ALL
 gint             ide_notification_compare                             (IdeNotification  *a,
                                                                        IdeNotification  *b);
-IDE_AVAILABLE_IN_3_32
+IDE_AVAILABLE_IN_ALL
 void             ide_notification_withdraw                            (IdeNotification  *self);
-IDE_AVAILABLE_IN_3_32
+IDE_AVAILABLE_IN_ALL
 void             ide_notification_withdraw_in_seconds                 (IdeNotification  *self,
                                                                        gint              seconds);
-IDE_AVAILABLE_IN_3_32
+IDE_AVAILABLE_IN_ALL
 void             ide_notification_file_progress_callback              (goffset           current_num_bytes,
                                                                        goffset           total_num_bytes,
                                                                        gpointer          user_data);
-IDE_AVAILABLE_IN_3_32
+IDE_AVAILABLE_IN_ALL
 void             ide_notification_flatpak_progress_callback           (const char       *status,
                                                                        guint             notification,
                                                                        gboolean          estimating,
diff --git a/src/libide/core/ide-notifications.c b/src/libide/core/ide-notifications.c
index 27fa54e22..c619cfde0 100644
--- a/src/libide/core/ide-notifications.c
+++ b/src/libide/core/ide-notifications.c
@@ -168,8 +168,6 @@ ide_notifications_class_init (IdeNotificationsClass *klass)
    *
    * The "has-progress" property denotes if any of the notifications
    * have progress supported.
-   *
-   * Since: 3.32
    */
   properties [PROP_HAS_PROGRESS] =
     g_param_spec_boolean ("has-progress",
@@ -184,8 +182,6 @@ ide_notifications_class_init (IdeNotificationsClass *klass)
    * The "progress" property is the combination of all of the notifications
    * currently monitored. It is updated when child notifications progress
    * changes.
-   *
-   * Since: 3.32
    */
   properties [PROP_PROGRESS] =
     g_param_spec_double ("progress",
@@ -199,8 +195,6 @@ ide_notifications_class_init (IdeNotificationsClass *klass)
    *
    * The "progress-is-imprecise" property indicates that all progress-bearing
    * notifications are imprecise.
-   *
-   * Since: 3.32
    */
   properties [PROP_PROGRESS_IS_IMPRECISE] =
     g_param_spec_boolean ("progress-is-imprecise",
@@ -305,8 +299,6 @@ ide_notifications_init (IdeNotifications *self)
  * #IdeObject will create it automatically.
  *
  * Returns: (transfer full): a newly created #IdeNotifications
- *
- * Since: 3.32
  */
 IdeNotifications *
 ide_notifications_new (void)
@@ -321,8 +313,6 @@ ide_notifications_new (void)
  *
  * Adds @notification as a child of @self, sorting it by priority
  * and urgency.
- *
- * Since: 3.32
  */
 void
 ide_notifications_add_notification (IdeNotifications *self,
@@ -394,8 +384,6 @@ collect_progress_cb (gpointer item,
  * #IdeNotifications object.
  *
  * Returns: A double between 0.0 and 1.0
- *
- * Since: 3.32
  */
 gdouble
 ide_notifications_get_progress (IdeNotifications *self)
@@ -426,8 +414,6 @@ ide_notifications_get_progress (IdeNotifications *self)
  * Gets if any of the notification support progress updates.
  *
  * Returns: %TRUE if any notification has progress
- *
- * Since: 3.32
  */
 gboolean
 ide_notifications_get_has_progress (IdeNotifications *self)
@@ -450,8 +436,6 @@ ide_notifications_get_has_progress (IdeNotifications *self)
  * Checks if all of the notifications with progress are imprecise.
  *
  * Returns: %TRUE if all progress-supporting notifications are imprecise.
- *
- * Since: 3.32
  */
 gboolean
 ide_notifications_get_progress_is_imprecise (IdeNotifications *self)
@@ -496,8 +480,6 @@ find_by_id (gpointer item,
  * #IdeNotification:id of @id.
  *
  * Returns: (transfer full) (nullable): an #IdeNotification or %NULL
- *
- * Since: 3.32
  */
 IdeNotification *
 ide_notifications_find_by_id (IdeNotifications *self,
diff --git a/src/libide/core/ide-notifications.h b/src/libide/core/ide-notifications.h
index fc482cfe4..89cd7de00 100644
--- a/src/libide/core/ide-notifications.h
+++ b/src/libide/core/ide-notifications.h
@@ -27,21 +27,21 @@ G_BEGIN_DECLS
 
 #define IDE_TYPE_NOTIFICATIONS (ide_notifications_get_type())
 
-IDE_AVAILABLE_IN_3_32
+IDE_AVAILABLE_IN_ALL
 G_DECLARE_FINAL_TYPE (IdeNotifications, ide_notifications, IDE, NOTIFICATIONS, IdeObject)
 
-IDE_AVAILABLE_IN_3_32
+IDE_AVAILABLE_IN_ALL
 IdeNotifications *ide_notifications_new                       (void);
-IDE_AVAILABLE_IN_3_32
+IDE_AVAILABLE_IN_ALL
 void              ide_notifications_add_notification          (IdeNotifications *self,
                                                                IdeNotification  *notification);
-IDE_AVAILABLE_IN_3_32
+IDE_AVAILABLE_IN_ALL
 gdouble           ide_notifications_get_progress              (IdeNotifications *self);
-IDE_AVAILABLE_IN_3_32
+IDE_AVAILABLE_IN_ALL
 gboolean          ide_notifications_get_has_progress          (IdeNotifications *self);
-IDE_AVAILABLE_IN_3_32
+IDE_AVAILABLE_IN_ALL
 gboolean          ide_notifications_get_progress_is_imprecise (IdeNotifications *self);
-IDE_AVAILABLE_IN_3_32
+IDE_AVAILABLE_IN_ALL
 IdeNotification  *ide_notifications_find_by_id                (IdeNotifications *self,
                                                                const gchar      *id);
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]