From 3aac70f245a222e8139360883295f8d29f6643d4 Mon Sep 17 00:00:00 2001 From: Marco Melorio Date: Sun, 12 Feb 2023 16:01:55 +0100 Subject: [PATCH 1/5] docs: Mark everything in GtkAssistant as deprecated --- gtk/deprecated/gtkassistant.c | 74 +++++++++++++++++++++++++++++++++++ 1 file changed, 74 insertions(+) diff --git a/gtk/deprecated/gtkassistant.c b/gtk/deprecated/gtkassistant.c index 0a96ed1931..485a0d3e19 100644 --- a/gtk/deprecated/gtkassistant.c +++ b/gtk/deprecated/gtkassistant.c @@ -60,12 +60,16 @@ * * `GtkAssistant` has a single CSS node with the name window and style * class .assistant. + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ /** * GtkAssistantPage: * * `GtkAssistantPage` is an auxiliary object used by `GtkAssistant. + * + * Deprecated: 4.10: This object will be removed in GTK 5 */ #include "config.h" @@ -275,6 +279,8 @@ gtk_assistant_page_class_init (GtkAssistantPageClass *class) * GtkAssistantPage:page-type: * * The type of the assistant page. + * + * Deprecated: 4.10: This object will be removed in GTK 5 */ g_object_class_install_property (object_class, CHILD_PROP_PAGE_TYPE, @@ -287,6 +293,8 @@ gtk_assistant_page_class_init (GtkAssistantPageClass *class) * GtkAssistantPage:title: * * The title of the page. + * + * Deprecated: 4.10: This object will be removed in GTK 5 */ g_object_class_install_property (object_class, CHILD_PROP_PAGE_TITLE, @@ -301,6 +309,8 @@ gtk_assistant_page_class_init (GtkAssistantPageClass *class) * * GTK uses this information to control the sensitivity * of the navigation buttons. + * + * Deprecated: 4.10: This object will be removed in GTK 5 */ g_object_class_install_property (object_class, CHILD_PROP_PAGE_COMPLETE, @@ -312,6 +322,8 @@ gtk_assistant_page_class_init (GtkAssistantPageClass *class) * GtkAssistantPage:child: * * The child widget. + * + * Deprecated: 4.10: This object will be removed in GTK 5 */ g_object_class_install_property (object_class, CHILD_PROP_CHILD, @@ -518,6 +530,8 @@ gtk_assistant_class_init (GtkAssistantClass *class) * @assistant: the `GtkAssistant` * * Emitted when then the cancel button is clicked. + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ signals[CANCEL] = g_signal_new (I_("cancel"), @@ -538,6 +552,8 @@ gtk_assistant_class_init (GtkAssistantClass *class) * * A handler for this signal can do any preparations which are * necessary before showing @page. + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ signals[PREPARE] = g_signal_new (I_("prepare"), @@ -563,6 +579,8 @@ gtk_assistant_class_init (GtkAssistantClass *class) * %GTK_ASSISTANT_PAGE_PROGRESS after the confirmation page and handle * this operation within the [signal@Gtk.Assistant::prepare] signal of * the progress page. + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ signals[APPLY] = g_signal_new (I_("apply"), @@ -580,6 +598,8 @@ gtk_assistant_class_init (GtkAssistantClass *class) * Emitted either when the close button of a summary page is clicked, * or when the apply button in the last page in the flow (of type * %GTK_ASSISTANT_PAGE_CONFIRM) is clicked. + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ signals[CLOSE] = g_signal_new (I_("close"), @@ -595,6 +615,8 @@ gtk_assistant_class_init (GtkAssistantClass *class) * @assistant: the `GtkAssistant` * * The action signal for the Escape binding. + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ signals[ESCAPE] = g_signal_new_class_handler (I_("escape"), @@ -618,6 +640,8 @@ gtk_assistant_class_init (GtkAssistantClass *class) * * For technical reasons, this property is declared as an integer * property, but you should only set it to %TRUE or %FALSE. + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ g_object_class_install_property (gobject_class, PROP_USE_HEADER_BAR, @@ -1435,6 +1459,8 @@ gtk_assistant_close_request (GtkWindow *window) * Creates a new `GtkAssistant`. * * Returns: a newly created `GtkAssistant` + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ GtkWidget* gtk_assistant_new (void) @@ -1455,6 +1481,8 @@ gtk_assistant_new (void) * Returns: The index (starting from 0) of the current * page in the @assistant, or -1 if the @assistant has no pages, * or no current page + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ int gtk_assistant_get_current_page (GtkAssistant *assistant) @@ -1480,6 +1508,8 @@ gtk_assistant_get_current_page (GtkAssistant *assistant) * Note that this will only be necessary in custom buttons, * as the @assistant flow can be set with * gtk_assistant_set_forward_page_func(). + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ void gtk_assistant_set_current_page (GtkAssistant *assistant, @@ -1525,6 +1555,8 @@ gtk_assistant_set_current_page (GtkAssistant *assistant, * * This function is for use when creating pages of the * %GTK_ASSISTANT_PAGE_CUSTOM type. + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ void gtk_assistant_next_page (GtkAssistant *assistant) @@ -1548,6 +1580,8 @@ gtk_assistant_next_page (GtkAssistant *assistant) * * This function is for use when creating pages of the * %GTK_ASSISTANT_PAGE_CUSTOM type. + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ void gtk_assistant_previous_page (GtkAssistant *assistant) @@ -1581,6 +1615,8 @@ gtk_assistant_previous_page (GtkAssistant *assistant) * Returns the number of pages in the @assistant * * Returns: the number of pages in the @assistant + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ int gtk_assistant_get_n_pages (GtkAssistant *assistant) @@ -1600,6 +1636,8 @@ gtk_assistant_get_n_pages (GtkAssistant *assistant) * * Returns: (nullable) (transfer none): the child widget, or %NULL * if @page_num is out of bounds + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ GtkWidget* gtk_assistant_get_nth_page (GtkAssistant *assistant, @@ -1632,6 +1670,8 @@ gtk_assistant_get_nth_page (GtkAssistant *assistant, * Prepends a page to the @assistant. * * Returns: the index (starting at 0) of the inserted page + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ int gtk_assistant_prepend_page (GtkAssistant *assistant, @@ -1651,6 +1691,8 @@ gtk_assistant_prepend_page (GtkAssistant *assistant, * Appends a page to the @assistant. * * Returns: the index (starting at 0) of the inserted page + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ int gtk_assistant_append_page (GtkAssistant *assistant, @@ -1672,6 +1714,8 @@ gtk_assistant_append_page (GtkAssistant *assistant, * Inserts a page in the @assistant at a given position. * * Returns: the index (starting from 0) of the inserted page + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ int gtk_assistant_insert_page (GtkAssistant *assistant, @@ -1770,6 +1814,8 @@ gtk_assistant_add_page (GtkAssistant *assistant, * or -1 to remove the last page * * Removes the @page_num’s page from @assistant. + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ void gtk_assistant_remove_page (GtkAssistant *assistant, @@ -1805,6 +1851,8 @@ gtk_assistant_remove_page (GtkAssistant *assistant, * Setting @page_func to %NULL will make the assistant to * use the default forward function, which just goes to the * next visible page. + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ void gtk_assistant_set_forward_page_func (GtkAssistant *assistant, @@ -1853,6 +1901,8 @@ add_to_action_area (GtkAssistant *assistant, * @child: a `GtkWidget` * * Adds a widget to the action area of a `GtkAssistant`. + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ void gtk_assistant_add_action_widget (GtkAssistant *assistant, @@ -1881,6 +1931,8 @@ gtk_assistant_add_action_widget (GtkAssistant *assistant, * @child: a `GtkWidget` * * Removes a widget from the action area of a `GtkAssistant`. + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ void gtk_assistant_remove_action_widget (GtkAssistant *assistant, @@ -1910,6 +1962,8 @@ gtk_assistant_remove_action_widget (GtkAssistant *assistant, * * The title is displayed in the header area of the assistant * when @page is the current page. + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ void gtk_assistant_set_page_title (GtkAssistant *assistant, @@ -1939,6 +1993,8 @@ gtk_assistant_set_page_title (GtkAssistant *assistant, * Gets the title for @page. * * Returns: the title for @page + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ const char * gtk_assistant_get_page_title (GtkAssistant *assistant, @@ -1968,6 +2024,8 @@ gtk_assistant_get_page_title (GtkAssistant *assistant, * Sets the page type for @page. * * The page type determines the page behavior in the @assistant. + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ void gtk_assistant_set_page_type (GtkAssistant *assistant, @@ -1997,6 +2055,8 @@ gtk_assistant_set_page_type (GtkAssistant *assistant, * Gets the page type of @page. * * Returns: the page type of @page + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ GtkAssistantPageType gtk_assistant_get_page_type (GtkAssistant *assistant, @@ -2027,6 +2087,8 @@ gtk_assistant_get_page_type (GtkAssistant *assistant, * * This will make @assistant update the buttons state * to be able to continue the task. + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ void gtk_assistant_set_page_complete (GtkAssistant *assistant, @@ -2056,6 +2118,8 @@ gtk_assistant_set_page_complete (GtkAssistant *assistant, * Gets whether @page is complete. * * Returns: %TRUE if @page is complete. + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ gboolean gtk_assistant_get_page_complete (GtkAssistant *assistant, @@ -2089,6 +2153,8 @@ gtk_assistant_get_page_complete (GtkAssistant *assistant, * One situation where it can be necessary to call this * function is when changing a value on the current page * affects the future page flow of the assistant. + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ void gtk_assistant_update_buttons_state (GtkAssistant *assistant) @@ -2112,6 +2178,8 @@ gtk_assistant_update_buttons_state (GtkAssistant *assistant) * or undone. For example, showing a progress page to track * a long-running, unreversible operation after the user has * clicked apply on a confirmation page. + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ void gtk_assistant_commit (GtkAssistant *assistant) @@ -2189,6 +2257,8 @@ gtk_assistant_buildable_custom_finished (GtkBuildable *buildable, * Returns the `GtkAssistantPage` object for @child. * * Returns: (transfer none): the `GtkAssistantPage` for @child + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ GtkAssistantPage * gtk_assistant_get_page (GtkAssistant *assistant, @@ -2205,6 +2275,8 @@ gtk_assistant_get_page (GtkAssistant *assistant, * Returns the child to which @page belongs. * * Returns: (transfer none): the child to which @page belongs + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ GtkWidget * gtk_assistant_page_get_child (GtkAssistantPage *page) @@ -2316,6 +2388,8 @@ gtk_assistant_pages_new (GtkAssistant *assistant) * Gets a list model of the assistant pages. * * Returns: (transfer full) (attributes element-type=GtkAssistantPage): A list model of the pages. + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ GListModel * gtk_assistant_get_pages (GtkAssistant *assistant) From 6e6f2f652c20f8508f851318651f65d69546e838 Mon Sep 17 00:00:00 2001 From: Marco Melorio Date: Sun, 12 Feb 2023 16:06:11 +0100 Subject: [PATCH 2/5] docs: Mark everything in GtkCellAreaContext as deprecated --- gtk/deprecated/gtkcellareacontext.c | 32 ++++++++++++++++++++--------- 1 file changed, 22 insertions(+), 10 deletions(-) diff --git a/gtk/deprecated/gtkcellareacontext.c b/gtk/deprecated/gtkcellareacontext.c index e16680888a..3333d286f0 100644 --- a/gtk/deprecated/gtkcellareacontext.c +++ b/gtk/deprecated/gtkcellareacontext.c @@ -34,6 +34,8 @@ * same context which was used to request sizes for a given `GtkTreeModel` * row also be used for the same row when calling other `GtkCellArea` APIs * such as gtk_cell_area_render() and gtk_cell_area_event(). + * + * Deprecated: 4.10: This object will be removed in GTK 5 */ #include "config.h" @@ -107,6 +109,8 @@ gtk_cell_area_context_class_init (GtkCellAreaContextClass *class) * GtkCellAreaContext:area: * * The `GtkCellArea` this context was created by + * + * Deprecated: 4.10: This object will be removed in GTK 5 */ g_object_class_install_property (object_class, PROP_CELL_AREA, @@ -120,6 +124,8 @@ gtk_cell_area_context_class_init (GtkCellAreaContextClass *class) * The minimum width for the `GtkCellArea` in this context * for all `GtkTreeModel` rows that this context was requested * for using gtk_cell_area_get_preferred_width(). + * + * Deprecated: 4.10: This object will be removed in GTK 5 */ g_object_class_install_property (object_class, PROP_MIN_WIDTH, @@ -133,6 +139,8 @@ gtk_cell_area_context_class_init (GtkCellAreaContextClass *class) * The natural width for the `GtkCellArea` in this context * for all `GtkTreeModel` rows that this context was requested * for using gtk_cell_area_get_preferred_width(). + * + * Deprecated: 4.10: This object will be removed in GTK 5 */ g_object_class_install_property (object_class, PROP_NAT_WIDTH, @@ -146,6 +154,8 @@ gtk_cell_area_context_class_init (GtkCellAreaContextClass *class) * The minimum height for the `GtkCellArea` in this context * for all `GtkTreeModel` rows that this context was requested * for using gtk_cell_area_get_preferred_height(). + * + * Deprecated: 4.10: This object will be removed in GTK 5 */ g_object_class_install_property (object_class, PROP_MIN_HEIGHT, @@ -159,6 +169,8 @@ gtk_cell_area_context_class_init (GtkCellAreaContextClass *class) * The natural height for the `GtkCellArea` in this context * for all `GtkTreeModel` rows that this context was requested * for using gtk_cell_area_get_preferred_height(). + * + * Deprecated: 4.10: This object will be removed in GTK 5 */ g_object_class_install_property (object_class, PROP_NAT_HEIGHT, @@ -309,7 +321,7 @@ gtk_cell_area_context_real_allocate (GtkCellAreaContext *context, * * Returns: (transfer none): the `GtkCellArea` this context was created by. * - * Deprecated: 4.10 + * Deprecated: 4.10: This object will be removed in GTK 5 */ GtkCellArea * gtk_cell_area_context_get_area (GtkCellAreaContext *context) @@ -348,7 +360,7 @@ gtk_cell_area_context_get_area (GtkCellAreaContext *context) * of all the displayed row heights using * gtk_cell_area_get_preferred_height_for_width(). * - * Deprecated: 4.10 + * Deprecated: 4.10: This object will be removed in GTK 5 */ void gtk_cell_area_context_reset (GtkCellAreaContext *context) @@ -377,7 +389,7 @@ gtk_cell_area_context_reset (GtkCellAreaContext *context) * rows. This is generally the case for `GtkTreeView` when * `GtkTreeView:fixed-height-mode` is enabled. * - * Deprecated: 4.10 + * Deprecated: 4.10: This object will be removed in GTK 5 */ void gtk_cell_area_context_allocate (GtkCellAreaContext *context, @@ -401,7 +413,7 @@ gtk_cell_area_context_allocate (GtkCellAreaContext *context, * After gtk_cell_area_context_reset() is called and/or before ever * requesting the size of a `GtkCellArea`, the returned values are 0. * - * Deprecated: 4.10 + * Deprecated: 4.10: This object will be removed in GTK 5 */ void gtk_cell_area_context_get_preferred_width (GtkCellAreaContext *context, @@ -431,7 +443,7 @@ gtk_cell_area_context_get_preferred_width (GtkCellAreaContext *context, * After gtk_cell_area_context_reset() is called and/or before ever * requesting the size of a `GtkCellArea`, the returned values are 0. * - * Deprecated: 4.10 + * Deprecated: 4.10: This object will be removed in GTK 5 */ void gtk_cell_area_context_get_preferred_height (GtkCellAreaContext *context, @@ -462,7 +474,7 @@ gtk_cell_area_context_get_preferred_height (GtkCellAreaContext *context, * After gtk_cell_area_context_reset() is called and/or before ever * requesting the size of a `GtkCellArea`, the returned values are -1. * - * Deprecated: 4.10 + * Deprecated: 4.10: This object will be removed in GTK 5 */ void gtk_cell_area_context_get_preferred_height_for_width (GtkCellAreaContext *context, @@ -492,7 +504,7 @@ gtk_cell_area_context_get_preferred_height_for_width (GtkCellAreaContext *contex * After gtk_cell_area_context_reset() is called and/or before ever * requesting the size of a `GtkCellArea`, the returned values are -1. * - * Deprecated: 4.10 + * Deprecated: 4.10: This object will be removed in GTK 5 */ void gtk_cell_area_context_get_preferred_width_for_height (GtkCellAreaContext *context, @@ -521,7 +533,7 @@ gtk_cell_area_context_get_preferred_width_for_height (GtkCellAreaContext *contex * context was recently reset with gtk_cell_area_context_reset(), * the returned value will be -1. * - * Deprecated: 4.10 + * Deprecated: 4.10: This object will be removed in GTK 5 */ void gtk_cell_area_context_get_allocation (GtkCellAreaContext *context, @@ -553,7 +565,7 @@ gtk_cell_area_context_get_allocation (GtkCellAreaContext *context, * progressively push the requested width over a series of * gtk_cell_area_get_preferred_width() requests. * - * Deprecated: 4.10 + * Deprecated: 4.10: This object will be removed in GTK 5 */ void gtk_cell_area_context_push_preferred_width (GtkCellAreaContext *context, @@ -597,7 +609,7 @@ gtk_cell_area_context_push_preferred_width (GtkCellAreaContext *context, * progressively push the requested height over a series of * gtk_cell_area_get_preferred_height() requests. * - * Deprecated: 4.10 + * Deprecated: 4.10: This object will be removed in GTK 5 */ void gtk_cell_area_context_push_preferred_height (GtkCellAreaContext *context, From b34c1390289f677f5e24def4a43676acf2ed4de0 Mon Sep 17 00:00:00 2001 From: Marco Melorio Date: Sun, 12 Feb 2023 16:12:17 +0100 Subject: [PATCH 3/5] docs: Mark everything in GtkLockButton as deprecated --- gtk/deprecated/gtklockbutton.c | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/gtk/deprecated/gtklockbutton.c b/gtk/deprecated/gtklockbutton.c index 39a0741e3b..d19bdc23b0 100644 --- a/gtk/deprecated/gtklockbutton.c +++ b/gtk/deprecated/gtklockbutton.c @@ -70,6 +70,8 @@ G_GNUC_BEGIN_IGNORE_DEPRECATIONS * [property@Gtk.LockButton:tooltip-lock], * [property@Gtk.LockButton:tooltip-unlock] and * [property@Gtk.LockButton:tooltip-not-authorized] properties. + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ struct _GtkLockButton @@ -271,6 +273,8 @@ gtk_lock_button_class_init (GtkLockButtonClass *klass) * GtkLockButton:permission: (attributes org.gtk.Property.get=gtk_lock_button_get_permission org.gtk.Property.set=gtk_lock_button_set_permission) * * The `GPermission object controlling this button. + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ g_object_class_install_property (gobject_class, PROP_PERMISSION, g_param_spec_object ("permission", NULL, NULL, @@ -282,6 +286,8 @@ gtk_lock_button_class_init (GtkLockButtonClass *klass) * GtkLockButton:text-lock: * * The text to display when prompting the user to lock. + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ g_object_class_install_property (gobject_class, PROP_TEXT_LOCK, g_param_spec_string ("text-lock", NULL, NULL, @@ -294,6 +300,8 @@ gtk_lock_button_class_init (GtkLockButtonClass *klass) * GtkLockButton:text-unlock: * * The text to display when prompting the user to unlock. + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ g_object_class_install_property (gobject_class, PROP_TEXT_UNLOCK, g_param_spec_string ("text-unlock", NULL, NULL, @@ -306,6 +314,8 @@ gtk_lock_button_class_init (GtkLockButtonClass *klass) * GtkLockButton:tooltip-lock: * * The tooltip to display when prompting the user to lock. + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ g_object_class_install_property (gobject_class, PROP_TOOLTIP_LOCK, g_param_spec_string ("tooltip-lock", NULL, NULL, @@ -318,6 +328,8 @@ gtk_lock_button_class_init (GtkLockButtonClass *klass) * GtkLockButton:tooltip-unlock: * * The tooltip to display when prompting the user to unlock. + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ g_object_class_install_property (gobject_class, PROP_TOOLTIP_UNLOCK, g_param_spec_string ("tooltip-unlock", NULL, NULL, @@ -330,6 +342,8 @@ gtk_lock_button_class_init (GtkLockButtonClass *klass) * GtkLockButton:tooltip-not-authorized: * * The tooltip to display when the user cannot obtain authorization. + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ g_object_class_install_property (gobject_class, PROP_TOOLTIP_NOT_AUTHORIZED, g_param_spec_string ("tooltip-not-authorized", NULL, NULL, @@ -511,6 +525,8 @@ gtk_lock_button_clicked (GtkButton *widget) * Creates a new lock button which reflects the @permission. * * Returns: a new `GtkLockButton` + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ GtkWidget * gtk_lock_button_new (GPermission *permission) @@ -527,6 +543,8 @@ gtk_lock_button_new (GPermission *permission) * Obtains the `GPermission` object that controls @button. * * Returns: (transfer none) (nullable): the `GPermission` of @button + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ GPermission * gtk_lock_button_get_permission (GtkLockButton *button) @@ -542,6 +560,8 @@ gtk_lock_button_get_permission (GtkLockButton *button) * @permission: (nullable): a `GPermission` object * * Sets the `GPermission` object that controls @button. + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ void gtk_lock_button_set_permission (GtkLockButton *button, From d45db3a961ffbcf93eb25ce94565f6e9b86bd3cc Mon Sep 17 00:00:00 2001 From: Marco Melorio Date: Sun, 12 Feb 2023 16:21:15 +0100 Subject: [PATCH 4/5] docs: Mark everything in GtkStatusBar as deprecated --- gtk/deprecated/gtkstatusbar.c | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/gtk/deprecated/gtkstatusbar.c b/gtk/deprecated/gtkstatusbar.c index a5bb70de54..6f9a40b6e5 100644 --- a/gtk/deprecated/gtkstatusbar.c +++ b/gtk/deprecated/gtkstatusbar.c @@ -77,6 +77,8 @@ G_GNUC_BEGIN_IGNORE_DEPRECATIONS * ## CSS node * * `GtkStatusbar` has a single CSS node with name `statusbar`. + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ typedef struct _GtkStatusbarMsg GtkStatusbarMsg; @@ -167,6 +169,8 @@ gtk_statusbar_class_init (GtkStatusbarClass *class) * @text: the message that was pushed * * Emitted whenever a new message gets pushed onto a statusbar's stack. + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ statusbar_signals[SIGNAL_TEXT_PUSHED] = g_signal_new (I_("text-pushed"), @@ -186,6 +190,8 @@ gtk_statusbar_class_init (GtkStatusbarClass *class) * @text: the message that was just popped * * Emitted whenever a new message is popped off a statusbar's stack. + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ statusbar_signals[SIGNAL_TEXT_POPPED] = g_signal_new (I_("text-popped"), @@ -225,6 +231,8 @@ gtk_statusbar_init (GtkStatusbar *statusbar) * Creates a new `GtkStatusbar` ready for messages. * * Returns: the new `GtkStatusbar` + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ GtkWidget* gtk_statusbar_new (void) @@ -257,6 +265,8 @@ gtk_statusbar_update (GtkStatusbar *statusbar, * Note that the description is not shown in the UI. * * Returns: an integer id + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ guint gtk_statusbar_get_context_id (GtkStatusbar *statusbar, @@ -317,6 +327,8 @@ gtk_statusbar_msg_free (GtkStatusbarMsg *msg) * * Returns: a message id that can be used with * [method@Gtk.Statusbar.remove]. + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ guint gtk_statusbar_push (GtkStatusbar *statusbar, @@ -351,6 +363,8 @@ gtk_statusbar_push (GtkStatusbar *statusbar, * Note that this may not change the displayed message, * if the message at the top of the stack has a different * context id. + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ void gtk_statusbar_pop (GtkStatusbar *statusbar, @@ -395,6 +409,8 @@ gtk_statusbar_pop (GtkStatusbar *statusbar, * * Forces the removal of a message from a statusbar’s stack. * The exact @context_id and @message_id must be specified. + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ void gtk_statusbar_remove (GtkStatusbar *statusbar, @@ -443,6 +459,8 @@ gtk_statusbar_remove (GtkStatusbar *statusbar, * * Forces the removal of all messages from a statusbar's * stack with the exact @context_id. + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ void gtk_statusbar_remove_all (GtkStatusbar *statusbar, @@ -499,6 +517,8 @@ gtk_statusbar_remove_all (GtkStatusbar *statusbar, * Retrieves the contents of the label in `GtkStatusbar`. * * Returns: (transfer none): the contents of the statusbar + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ const char * gtk_statusbar_get_message (GtkStatusbar *statusbar) From 2504215459c4164b109ef5f87106c534e27c105b Mon Sep 17 00:00:00 2001 From: Marco Melorio Date: Sun, 12 Feb 2023 16:23:16 +0100 Subject: [PATCH 5/5] docs: Mark everything in GtkVolumeButton as deprecated --- gtk/deprecated/gtkvolumebutton.c | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/gtk/deprecated/gtkvolumebutton.c b/gtk/deprecated/gtkvolumebutton.c index ce6e535703..ab6655b9bc 100644 --- a/gtk/deprecated/gtkvolumebutton.c +++ b/gtk/deprecated/gtkvolumebutton.c @@ -44,6 +44,8 @@ G_GNUC_BEGIN_IGNORE_DEPRECATIONS * volume control. * * ![An example GtkVolumeButton](volumebutton.png) + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ typedef struct _GtkVolumeButtonClass GtkVolumeButtonClass; @@ -168,6 +170,8 @@ gtk_volume_button_class_init (GtkVolumeButtonClass *klass) * * Note that if the symbolic icons are not available in your installed * theme, then the normal (potentially colorful) icons will be used. + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ g_object_class_install_property (gobject_class, PROP_SYMBOLIC, @@ -200,6 +204,8 @@ gtk_volume_button_init (GtkVolumeButton *button) * [class@Gtk.ScaleButton]. * * Returns: a new `GtkVolumeButton` + * + * Deprecated: 4.10: This widget will be removed in GTK 5 */ GtkWidget * gtk_volume_button_new (void)