[gtk/gtk-3-24] container: Deprecate focus chains

[Benjamin Otte <otte src gnome org>]

commit 6e4da8fbdbcbe8b9c67c5ab5ce9a31a83ce352ee
Author: Benjamin Otte <otte redhat com>
Date:   Tue Jul 31 22:42:26 2018 +0200

    container: Deprecate focus chains

 gtk/gtkcontainer.c | 9 +++++++++
 gtk/gtkcontainer.h | 6 +++---
 2 files changed, 12 insertions(+), 3 deletions(-)
---
diff --git a/gtk/gtkcontainer.c b/gtk/gtkcontainer.c
index 0900782fb9..88f1fc415e 100644
--- a/gtk/gtkcontainer.c
+++ b/gtk/gtkcontainer.c
@@ -3340,6 +3340,9 @@ chain_widget_destroyed (GtkWidget *widget,
  * to set the focus chain before you pack the widgets, or have a widget
  * in the chain that isn’t always packed. The necessary checks are done
  * when the focus chain is actually traversed.
+ *
+ * Deprecated: 3.24: For overriding focus behavior, use the
+ *     GtkWidgetClass::focus signal.
  **/
 void
 gtk_container_set_focus_chain (GtkContainer *container,
@@ -3404,6 +3407,9 @@ gtk_container_set_focus_chain (GtkContainer *container,
  *
  * Returns: %TRUE if the focus chain of the container
  * has been set explicitly.
+ *
+ * Deprecated: 3.24: For overriding focus behavior, use the
+ *     GtkWidgetClass::focus signal.
  **/
 gboolean
 gtk_container_get_focus_chain (GtkContainer *container,
@@ -3431,6 +3437,9 @@ gtk_container_get_focus_chain (GtkContainer *container,
  * @container: a #GtkContainer
  *
  * Removes a focus chain explicitly set with gtk_container_set_focus_chain().
+ *
+ * Deprecated: 3.24: For overriding focus behavior, use the
+ *     GtkWidgetClass::focus signal.
  **/
 void
 gtk_container_unset_focus_chain (GtkContainer  *container)
diff --git a/gtk/gtkcontainer.h b/gtk/gtkcontainer.h
index ea87bd91c8..70a429bcf7 100644
--- a/gtk/gtkcontainer.h
+++ b/gtk/gtkcontainer.h
@@ -172,13 +172,13 @@ void     gtk_container_propagate_draw   (GtkContainer   *container,
                                         GtkWidget      *child,
                                         cairo_t        *cr);
 
-GDK_AVAILABLE_IN_ALL
+GDK_DEPRECATED_IN_3_24
 void     gtk_container_set_focus_chain  (GtkContainer   *container,
                                          GList          *focusable_widgets);
-GDK_AVAILABLE_IN_ALL
+GDK_DEPRECATED_IN_3_24
 gboolean gtk_container_get_focus_chain  (GtkContainer   *container,
                                         GList         **focusable_widgets);
-GDK_AVAILABLE_IN_ALL
+GDK_DEPRECATED_IN_3_24
 void     gtk_container_unset_focus_chain (GtkContainer  *container);
 
 #define GTK_IS_RESIZE_CONTAINER(widget) (GTK_IS_CONTAINER (widget) && \