[gtkmm] Gtk::Container, Widget: Deprecate API which is deprecated in GTK+

[Kjell Ahlstedt <kjellahl src gnome org>]

commit 31e4c5f85d0e8c2fd02f6d025be62d77179d5f06
Author: Kjell Ahlstedt <kjell ahlstedt bredband net>
Date:   Sun Jun 1 16:20:18 2014 +0200

    Gtk::Container, Widget: Deprecate API which is deprecated in GTK+
    
    * gtk/src/container.hg: Deprecate [set|get]_resize_mode(),
    set_reallocate_redraws().
    * gtk/src/widget.hg: Deprecate reparent(), region_intersect(),
    get_root_window(), [set|get]_margin_[left|right](), property_style(),
    property_margin_[left|right]().
    property_style() should perhaps be deleted, although that would break API and
    ABI. It can't be used because it requires the non-existent Gtk::Style class.

 gtk/src/container.hg |    9 ++++++---
 gtk/src/widget.hg    |   26 ++++++++++++++------------
 2 files changed, 20 insertions(+), 15 deletions(-)
---
diff --git a/gtk/src/container.hg b/gtk/src/container.hg
index 94772fb..99f551f 100644
--- a/gtk/src/container.hg
+++ b/gtk/src/container.hg
@@ -82,10 +82,12 @@ public:
   _IGNORE(gtk_container_remove)
 
   _WRAP_METHOD(void set_resize_mode(ResizeMode resize_mode),
-               gtk_container_set_resize_mode)
+               gtk_container_set_resize_mode,
+               deprecated "Resize modes are deprecated. They aren’t necessary anymore since frame clocks and 
might introduce obscure bugs if used.")
 
   _WRAP_METHOD(ResizeMode get_resize_mode() const,
-               gtk_container_get_resize_mode)
+               gtk_container_get_resize_mode,
+               deprecated "Resize modes are deprecated. They aren’t necessary anymore since frame clocks and 
might introduce obscure bugs if used.")
 
   /// Request that contained widgets check their size
   _WRAP_METHOD(void check_resize(), gtk_container_check_resize)
@@ -151,7 +153,8 @@ public:
 /* Widget-level methods */
 
   _WRAP_METHOD(void set_reallocate_redraws(bool needs_redraws = true),
-               gtk_container_set_reallocate_redraws)
+               gtk_container_set_reallocate_redraws,
+               deprecated "Call Gtk::Widget::queue_draw() in your Gtk::Widget::signal_size_allocate() 
handler.")
 
   /// Sets the focus on a child
   _WRAP_METHOD(void set_focus_child(Widget& widget),gtk_container_set_focus_child)
diff --git a/gtk/src/widget.hg b/gtk/src/widget.hg
index aea0549..fd5181a 100644
--- a/gtk/src/widget.hg
+++ b/gtk/src/widget.hg
@@ -178,14 +178,15 @@ public:
   _WRAP_METHOD(bool send_focus_change(GdkEvent* event), gtk_widget_send_focus_change)
   _WRAP_METHOD(bool activate(), gtk_widget_activate)
 
-  _WRAP_METHOD(void reparent(Widget & new_parent), gtk_widget_reparent)
+  _WRAP_METHOD(void reparent(Widget& new_parent), gtk_widget_reparent, deprecated "Use Container::remove() 
and Container::add() instead.")
 
   bool intersect(const Gdk::Rectangle& area) const;
   _WRAP_METHOD(bool intersect(const Gdk::Rectangle& area, Gdk::Rectangle& intersection) const, 
gtk_widget_intersect)
 
 #m4 _CONVERSION(`cairo_region_t*',`::Cairo::RefPtr< ::Cairo::Region>',`::Cairo::RefPtr< ::Cairo::Region>(new 
::Cairo::Region($3, true /* do not take ref */))')
 
-  _WRAP_METHOD(::Cairo::RefPtr< ::Cairo::Region> region_intersect(const ::Cairo::RefPtr< ::Cairo::Region>& 
region) const, gtk_widget_region_intersect)
+  _WRAP_METHOD(::Cairo::RefPtr< ::Cairo::Region> region_intersect(const ::Cairo::RefPtr< ::Cairo::Region>& 
region) const, gtk_widget_region_intersect,
+               deprecated "Use get_allocation() and Cairo::Region::intersect(const Cairo::RectangleInt&) to 
get the same behavior.")
 
   _WRAP_METHOD(void freeze_child_notify(), gtk_widget_freeze_child_notify)
   _WRAP_METHOD(void child_notify(const Glib::ustring& child_property), gtk_widget_child_notify)
@@ -335,8 +336,8 @@ public:
   _WRAP_METHOD(Glib::RefPtr<Gdk::Display> get_display(), gtk_widget_get_display, refreturn)
   _WRAP_METHOD(Glib::RefPtr<const Gdk::Display> get_display() const, gtk_widget_get_display, refreturn, 
constversion)
 
-  _WRAP_METHOD(Glib::RefPtr<Gdk::Window> get_root_window(), gtk_widget_get_root_window, refreturn)
-  _WRAP_METHOD(Glib::RefPtr<const Gdk::Window> get_root_window() const, gtk_widget_get_root_window, 
refreturn, constversion)
+  _WRAP_METHOD(Glib::RefPtr<Gdk::Window> get_root_window(), gtk_widget_get_root_window, refreturn, 
deprecated "Use Gdk::Screen::get_root_window() instead.")
+  _WRAP_METHOD(Glib::RefPtr<const Gdk::Window> get_root_window() const, gtk_widget_get_root_window, 
refreturn, constversion, deprecated "Use Gdk::Screen::get_root_window() instead.")
 
   _WRAP_METHOD(Glib::RefPtr<Settings> get_settings(), gtk_widget_get_settings, refreturn)
 
@@ -365,10 +366,10 @@ public:
   _WRAP_METHOD(Align get_valign() const, gtk_widget_get_valign)
   _WRAP_METHOD(Align get_valign_with_baseline() const, gtk_widget_get_valign_with_baseline)
   _WRAP_METHOD(void set_valign(Align align), gtk_widget_set_valign)
-  _WRAP_METHOD(int get_margin_left() const, gtk_widget_get_margin_left)
-  _WRAP_METHOD(void set_margin_left(int margin), gtk_widget_set_margin_left)
-  _WRAP_METHOD(int get_margin_right() const, gtk_widget_get_margin_right)
-  _WRAP_METHOD(void set_margin_right(int margin), gtk_widget_set_margin_right)
+  _WRAP_METHOD(int get_margin_left() const, gtk_widget_get_margin_left, deprecated "Use get_margin_start() 
instead.")
+  _WRAP_METHOD(void set_margin_left(int margin), gtk_widget_set_margin_left, deprecated "Use 
set_margin_start() instead.")
+  _WRAP_METHOD(int get_margin_right() const, gtk_widget_get_margin_right, deprecated "Use get_margin_end() 
instead.")
+  _WRAP_METHOD(void set_margin_right(int margin), gtk_widget_set_margin_right, deprecated "Use 
set_margin_end() instead.")
   _WRAP_METHOD(int get_margin_start() const, gtk_widget_get_margin_start)
   _WRAP_METHOD(void set_margin_start(int margin), gtk_widget_set_margin_start)
   _WRAP_METHOD(int get_margin_end() const, gtk_widget_get_margin_end)
@@ -712,7 +713,8 @@ dnl
   _WRAP_SIGNAL(bool selection_notify_event(GdkEventSelection* event), "selection_notify_event")
   _WRAP_SIGNAL(bool proximity_in_event(GdkEventProximity* event), "proximity_in_event")
   _WRAP_SIGNAL(bool proximity_out_event(GdkEventProximity* event), "proximity_out_event")
-  _WRAP_SIGNAL(bool visibility_notify_event(GdkEventVisibility* event), "visibility_notify_event")
+  _WRAP_SIGNAL(bool visibility_notify_event(GdkEventVisibility* event), "visibility_notify_event",
+    deprecated "Modern composited windowing systems with pervasive transparency make it impossible to track 
the visibility of a window reliably, so this signal can not be guaranteed to provide useful information.")
   _WRAP_SIGNAL(bool window_state_event(GdkEventWindowState* event), "window_state_event")
 
   //We use the optional custom_c_callback parameter with _WRAP_SIGNAL() for some of these,
@@ -778,7 +780,7 @@ _CONVERSION(`GdkScreen*',`const Glib::RefPtr<Gdk::Screen>&',`Glib::wrap($3, true
   _WRAP_PROPERTY("has_default", bool)
   _WRAP_PROPERTY("receives_default", bool)
   _WRAP_PROPERTY("composite_child", bool)
-  _WRAP_PROPERTY("style", Glib::RefPtr<Style>)
+  _WRAP_PROPERTY("style", Glib::RefPtr<Style>, deprecated "Don't use this API. There is no Style class in 
gtkmm 3.")
   _WRAP_PROPERTY("events", Gdk::EventMask)
   _WRAP_PROPERTY("has_tooltip", bool)
   _WRAP_PROPERTY("tooltip_markup", Glib::ustring)
@@ -789,8 +791,8 @@ _CONVERSION(`GdkScreen*',`const Glib::RefPtr<Gdk::Screen>&',`Glib::wrap($3, true
 
   _WRAP_PROPERTY("halign", Align)
   _WRAP_PROPERTY("valign", Align)
-  _WRAP_PROPERTY("margin-left", int)
-  _WRAP_PROPERTY("margin-right", int)
+  _WRAP_PROPERTY("margin-left", int, deprecated "Use property_margin_start() instead.")
+  _WRAP_PROPERTY("margin-right", int, deprecated "Use property_margin_end() instead.")
   _WRAP_PROPERTY("margin-start", int)
   _WRAP_PROPERTY("margin-end", int)
   _WRAP_PROPERTY("margin-top", int)