From 2a6e1498ba96e4710e7e19e2ddffea71f3c941d0 Mon Sep 17 00:00:00 2001
From: Benjamin Otte <otte@redhat.com>
Date: Wed, 4 Nov 2015 05:06:31 +0100
Subject: [PATCH] testutils: Deprecate a bunch of ugly functions

We've by now disabled and then remved all of the tests that use these
functions because they never worked properly. So let's depecate these
functions before somebody starts using them.
---
 gtk/gtktestutils.c | 18 ++++++++++++++++++
 gtk/gtktestutils.h | 18 +++++++++---------
 2 files changed, 27 insertions(+), 9 deletions(-)

diff --git a/gtk/gtktestutils.c b/gtk/gtktestutils.c
index 78bb2586fb..7973b0230f 100644
--- a/gtk/gtktestutils.c
+++ b/gtk/gtktestutils.c
@@ -219,6 +219,8 @@ gtk_test_widget_send_key (GtkWidget      *widget,
  * Returns: whether all actions neccessary for the button click simulation were carried out successfully.
  *
  * Since: 2.14
+ *
+ * Deprecated: 3.20: This testing infrastructure is phased out in favor of reftests.
  **/
 gboolean
 gtk_test_widget_click (GtkWidget      *widget,
@@ -250,6 +252,8 @@ gtk_test_widget_click (GtkWidget      *widget,
  * Returns: whether all actions neccessary for the button click simulation were carried out successfully.
  *
  * Since: 2.14
+ *
+ * Deprecated: 3.20: This testing infrastructure is phased out in favor of reftests.
  **/
 gboolean
 gtk_test_spin_button_click (GtkSpinButton  *spinner,
@@ -464,6 +468,8 @@ gtk_test_find_widget (GtkWidget    *widget,
  * @percentage argument.
  *
  * Since: 2.14
+ *
+ * Deprecated: 3.20: This testing infrastructure is phased out in favor of reftests.
  **/
 void
 gtk_test_slider_set_perc (GtkWidget      *widget,
@@ -496,6 +502,8 @@ gtk_test_slider_set_perc (GtkWidget      *widget,
  * Returns: gtk_adjustment_get_value (adjustment) for an adjustment belonging to @widget.
  *
  * Since: 2.14
+ *
+ * Deprecated: 3.20: This testing infrastructure is phased out in favor of reftests.
  **/
 double
 gtk_test_slider_get_value (GtkWidget *widget)
@@ -517,6 +525,8 @@ gtk_test_slider_get_value (GtkWidget *widget)
  * GtkEditable (entry and text widgets) or GtkTextView.
  *
  * Since: 2.14
+ *
+ * Deprecated: 3.20: This testing infrastructure is phased out in favor of reftests.
  **/
 void
 gtk_test_text_set (GtkWidget   *widget,
@@ -547,6 +557,8 @@ gtk_test_text_set (GtkWidget   *widget,
  * Returns: new 0-terminated C string, needs to be released with g_free().
  *
  * Since: 2.14
+ *
+ * Deprecated: 3.20: This testing infrastructure is phased out in favor of reftests.
  **/
 gchar*
 gtk_test_text_get (GtkWidget *widget)
@@ -583,6 +595,8 @@ gtk_test_text_get (GtkWidget *widget)
  * Returns: (transfer none): a newly created widget.
  *
  * Since: 2.14
+ *
+ * Deprecated: 3.20: This testing infrastructure is phased out in favor of reftests.
  */
 GtkWidget*
 gtk_test_create_widget (GType        widget_type,
@@ -641,6 +655,8 @@ test_increment_intp (int *intp)
  * Returns: (transfer full): a widget pointer to the newly created GtkWindow.
  *
  * Since: 2.14
+ *
+ * Deprecated: 3.20: This testing infrastructure is phased out in favor of reftests.
  **/
 GtkWidget*
 gtk_test_display_button_window (const gchar *window_title,
@@ -683,6 +699,8 @@ gtk_test_display_button_window (const gchar *window_title,
  * Returns: (transfer none): a widget pointer to the newly created GtkWindow.
  *
  * Since: 2.14
+ *
+ * Deprecated: 3.20: This testing infrastructure is phased out in favor of reftests.
  **/
 GtkWidget*
 gtk_test_create_simple_window (const gchar *window_title,
diff --git a/gtk/gtktestutils.h b/gtk/gtktestutils.h
index badbd1f372..bdf2515fcc 100644
--- a/gtk/gtktestutils.h
+++ b/gtk/gtktestutils.h
@@ -41,29 +41,29 @@ GDK_AVAILABLE_IN_ALL
 GtkWidget*      gtk_test_find_widget            (GtkWidget      *widget,
                                                  const gchar    *label_pattern,
                                                  GType           widget_type);
-GDK_AVAILABLE_IN_ALL
+GDK_DEPRECATED_IN_3_20
 GtkWidget*      gtk_test_create_widget          (GType           widget_type,
                                                  const gchar    *first_property_name,
                                                  ...);
-GDK_AVAILABLE_IN_ALL
+GDK_DEPRECATED_IN_3_20
 GtkWidget*      gtk_test_create_simple_window   (const gchar    *window_title,
                                                  const gchar    *dialog_text);
-GDK_AVAILABLE_IN_ALL
+GDK_DEPRECATED_IN_3_20
 GtkWidget*      gtk_test_display_button_window  (const gchar    *window_title,
                                                  const gchar    *dialog_text,
                                                  ...); /* NULL terminated list of (label, &int) pairs */
-GDK_AVAILABLE_IN_ALL
+GDK_DEPRECATED_IN_3_20
 void            gtk_test_slider_set_perc        (GtkWidget      *widget, /* GtkRange-alike */
                                                  double          percentage);
-GDK_AVAILABLE_IN_ALL
+GDK_DEPRECATED_IN_3_20
 double          gtk_test_slider_get_value       (GtkWidget      *widget);
-GDK_AVAILABLE_IN_ALL
+GDK_DEPRECATED_IN_3_20
 gboolean        gtk_test_spin_button_click      (GtkSpinButton  *spinner,
                                                  guint           button,
                                                  gboolean        upwards);
 GDK_AVAILABLE_IN_3_10
 void            gtk_test_widget_wait_for_draw   (GtkWidget      *widget);
-GDK_AVAILABLE_IN_ALL
+GDK_DEPRECATED_IN_3_20
 gboolean        gtk_test_widget_click           (GtkWidget      *widget,
                                                  guint           button,
                                                  GdkModifierType modifiers);
@@ -72,10 +72,10 @@ gboolean        gtk_test_widget_send_key        (GtkWidget      *widget,
                                                  guint           keyval,
                                                  GdkModifierType modifiers);
 /* operate on GtkEntry, GtkText, GtkTextView or GtkLabel */
-GDK_AVAILABLE_IN_ALL
+GDK_DEPRECATED_IN_3_20
 void            gtk_test_text_set               (GtkWidget      *widget,
                                                  const gchar    *string);
-GDK_AVAILABLE_IN_ALL
+GDK_DEPRECATED_IN_3_20
 gchar*          gtk_test_text_get               (GtkWidget      *widget);
 
 /* --- Gtk+ Test low-level API --- */