[gtkmm] Gdk::Window and others: Deprecate API which is deprecated in gtk+

[Kjell Ahlstedt <kjellahl src gnome org>]

commit 442d43a332b3e832e9acf26620ce982dece8b991
Author: Kjell Ahlstedt <kjell ahlstedt bredband net>
Date:   Tue Mar 24 15:08:09 2015 +0100

    Gdk::Window and others: Deprecate API which is deprecated in gtk+
    
    * gdk/src/display.hg: Deprecate open_default_libgtk_only() and
    supports_composite().
    * gdk/src/window.hg: Deprecate get/set_composited(), set_static_gravities()
    and flush().
    * gtk/src/cellrendererpixbuf.hg: Deprecate property_follow_state().

 gdk/src/display.hg            |    6 ++++--
 gdk/src/window.hg             |   11 +++++++----
 gtk/src/cellrendererpixbuf.hg |    2 +-
 3 files changed, 12 insertions(+), 7 deletions(-)
---
diff --git a/gdk/src/display.hg b/gdk/src/display.hg
index 3f8f695..a4b43b6 100644
--- a/gdk/src/display.hg
+++ b/gdk/src/display.hg
@@ -92,7 +92,8 @@ public:
 
   _IGNORE(gdk_display_get_pointer, gdk_display_get_window_at_pointer, gdk_display_warp_pointer) //deprecated
 
-  _WRAP_METHOD(static Glib::RefPtr<Display> open_default_libgtk_only(), 
gdk_display_open_default_libgtk_only, refreturn)
+  _WRAP_METHOD(static Glib::RefPtr<Display> open_default_libgtk_only(), 
gdk_display_open_default_libgtk_only, refreturn,
+               deprecated "This method was never meant to be used outside of GTK+.")
 
   _WRAP_METHOD(GdkKeymap* get_keymap(), gdk_keymap_get_for_display)
   _WRAP_METHOD(const GdkKeymap* get_keymap() const, gdk_keymap_get_for_display, constversion)
@@ -143,7 +144,8 @@ public:
 
   _WRAP_METHOD(bool supports_shapes() const, gdk_display_supports_shapes)
   _WRAP_METHOD(bool supports_input_shapes() const, gdk_display_supports_input_shapes)
-  _WRAP_METHOD(bool supports_composite() const, gdk_display_supports_composite)
+  _WRAP_METHOD(bool supports_composite() const, gdk_display_supports_composite,
+               deprecated "Compositing is an outdated technology that only ever worked on X11.")
   _WRAP_METHOD(void notify_startup_complete(const Glib::ustring& startup_id), 
gdk_display_notify_startup_complete)
 
   _WRAP_METHOD(Glib::RefPtr<DeviceManager> get_device_manager(), gdk_display_get_device_manager, refreturn)
diff --git a/gdk/src/window.hg b/gdk/src/window.hg
index 91aac53..bb92735 100644
--- a/gdk/src/window.hg
+++ b/gdk/src/window.hg
@@ -122,8 +122,10 @@ public:
 
   _WRAP_METHOD(void shape_combine_region(const ::Cairo::RefPtr< ::Cairo::Region>& shape_region, int offset_x 
= 0, int offset_y = 0), gdk_window_shape_combine_region)
   _WRAP_METHOD(void set_child_shapes(), gdk_window_set_child_shapes)
-  _WRAP_METHOD(bool get_composited() const, gdk_window_get_composited)
-  _WRAP_METHOD(void set_composited(bool composited = TRUE), gdk_window_set_composited)
+  _WRAP_METHOD(bool get_composited() const, gdk_window_get_composited,
+               deprecated "Compositing is an outdated technology that only ever worked on X11.")
+  _WRAP_METHOD(void set_composited(bool composited = TRUE), gdk_window_set_composited,
+               deprecated "Compositing is an outdated technology that only ever worked on X11.")
   _WRAP_METHOD(void merge_child_shapes(), gdk_window_merge_child_shapes)
 
   _WRAP_METHOD(void input_shape_combine_region(const ::Cairo::RefPtr< ::Cairo::Region>& shape_region, int 
offset_x, int offset_y), gdk_window_input_shape_combine_region)
@@ -135,7 +137,8 @@ public:
   _WRAP_METHOD(bool is_input_only() const, gdk_window_is_input_only)
   _WRAP_METHOD(bool is_shaped() const, gdk_window_is_shaped)
   _WRAP_METHOD(WindowState get_state() const, gdk_window_get_state)
-  _WRAP_METHOD(bool set_static_gravities(bool use_static = true), gdk_window_set_static_gravities)
+  _WRAP_METHOD(bool set_static_gravities(bool use_static = true), gdk_window_set_static_gravities,
+               deprecated "Static gravities haven't worked on anything but X11 for a long time.")
   _WRAP_METHOD(bool has_native() const, gdk_window_has_native)
   _WRAP_METHOD(void set_type_hint(WindowTypeHint hint), gdk_window_set_type_hint)
   _WRAP_METHOD(WindowTypeHint get_type_hint(), gdk_window_get_type_hint)
@@ -145,7 +148,7 @@ public:
   _WRAP_METHOD(void begin_paint_rect(const Rectangle& rectangle), gdk_window_begin_paint_rect)
   _WRAP_METHOD(void begin_paint_region(const ::Cairo::RefPtr< ::Cairo::Region>& region), 
gdk_window_begin_paint_region)
   _WRAP_METHOD(void end_paint(), gdk_window_end_paint)
-  _WRAP_METHOD(void flush(), gdk_window_flush)
+  _WRAP_METHOD(void flush(), gdk_window_flush, deprecated "This method does nothing.")
   _WRAP_METHOD(void set_title(const Glib::ustring& title), gdk_window_set_title)
   _WRAP_METHOD(void set_role(const Glib::ustring& role), gdk_window_set_role)
   _WRAP_METHOD(void set_startup_id(const Glib::ustring& startup_id), gdk_window_set_startup_id)
diff --git a/gtk/src/cellrendererpixbuf.hg b/gtk/src/cellrendererpixbuf.hg
index 0d26ca0..734dc46 100644
--- a/gtk/src/cellrendererpixbuf.hg
+++ b/gtk/src/cellrendererpixbuf.hg
@@ -50,7 +50,7 @@ public:
   _WRAP_PROPERTY("stock_size", guint)
   _WRAP_PROPERTY("stock_detail", Glib::ustring)
   _WRAP_PROPERTY("icon-name", Glib::ustring)
-  _WRAP_PROPERTY("follow-state", bool)
+  _WRAP_PROPERTY("follow-state", bool, deprecated "Cell renderers always follow state.")
   _WRAP_PROPERTY("gicon", Glib::RefPtr<Gio::Icon>)
   _WRAP_PROPERTY("surface", ::Cairo::RefPtr< ::Cairo::Surface>)