[gtk+] Deprecate gtk_widget_get_root_window

[Matthias Clasen <matthiasc src gnome org>]

commit 5034920f7809181bcfaf4d84ef9b8e1fabf0fb9f
Author: Matthias Clasen <mclasen redhat com>
Date:   Fri Jan 24 20:15:10 2014 -0500

    Deprecate gtk_widget_get_root_window
    
    The root window is a fairly X-centric concept, and it
    really has no place in the GtkWidget API. Plus, this
    is a rarely-used one-line convenience function with
    poor documentation.

 gtk/gtkwidget.c |    4 +++-
 gtk/gtkwidget.h |    2 +-
 2 files changed, 4 insertions(+), 2 deletions(-)
---
diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index 896ff39..f4246ac 100644
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -10177,7 +10177,9 @@ gtk_widget_get_display (GtkWidget *widget)
  * Return value: (transfer none): the #GdkWindow root window for the toplevel for this widget.
  *
  * Since: 2.2
- **/
+ *
+ * Deprecated: 3.12: Use gdk_screen_get_root_window() instead
+ */
 GdkWindow*
 gtk_widget_get_root_window (GtkWidget *widget)
 {
diff --git a/gtk/gtkwidget.h b/gtk/gtkwidget.h
index 0a657a7..1f6318f 100644
--- a/gtk/gtkwidget.h
+++ b/gtk/gtkwidget.h
@@ -1010,7 +1010,7 @@ GDK_AVAILABLE_IN_3_10
 gint          gtk_widget_get_scale_factor (GtkWidget *widget);
 GDK_AVAILABLE_IN_ALL
 GdkDisplay *  gtk_widget_get_display     (GtkWidget *widget);
-GDK_AVAILABLE_IN_ALL
+GDK_DEPRECATED_IN_3_12
 GdkWindow *   gtk_widget_get_root_window (GtkWidget *widget);
 GDK_AVAILABLE_IN_ALL
 GtkSettings*  gtk_widget_get_settings    (GtkWidget *widget);