[gtkmm] Gdk::Display, Gdk::Visual: Deprecate methods which are deprecated in gtk+

[Kjell Ahlstedt <kjellahl src gnome org>]

commit 9ffa6f4ad07a58d358f9538de6a8294d5e56eb1c
Author: Kjell Ahlstedt <kjell ahlstedt bredband net>
Date:   Sun May 8 09:27:50 2016 +0200

    Gdk::Display, Gdk::Visual: Deprecate methods which are deprecated in gtk+

 gdk/src/display.hg |    6 ++++--
 gdk/src/visual.hg  |    9 ++++++---
 2 files changed, 10 insertions(+), 5 deletions(-)
---
diff --git a/gdk/src/display.hg b/gdk/src/display.hg
index a25a6d1..dece178 100644
--- a/gdk/src/display.hg
+++ b/gdk/src/display.hg
@@ -54,8 +54,10 @@ public:
   _WRAP_METHOD(Glib::ustring get_name() const, gdk_display_get_name)
 
   _WRAP_METHOD(int get_n_screens() const, gdk_display_get_n_screens, deprecated "The number of screens is 
always 1.")
-  _WRAP_METHOD(Glib::RefPtr<Screen> get_screen(int screen_num = 0), gdk_display_get_screen, refreturn)
-  _WRAP_METHOD(Glib::RefPtr<const Screen> get_screen(int screen_num = 0) const, gdk_display_get_screen, 
refreturn, constversion)
+  _WRAP_METHOD(Glib::RefPtr<Screen> get_screen(int screen_num = 0), gdk_display_get_screen, refreturn,
+    deprecated "There is only one screen; use get_default_screen() to get it.")
+  _WRAP_METHOD(Glib::RefPtr<const Screen> get_screen(int screen_num = 0) const, gdk_display_get_screen, 
refreturn, constversion,
+    deprecated "There is only one screen; use get_default_screen() to get it.")
 
   _WRAP_METHOD(Glib::RefPtr<Screen> get_default_screen(), gdk_display_get_default_screen, refreturn)
   _WRAP_METHOD(Glib::RefPtr<const Screen> get_default_screen() const, gdk_display_get_default_screen, 
refreturn, constversion)
diff --git a/gdk/src/visual.hg b/gdk/src/visual.hg
index 7fd3752..1604e49 100644
--- a/gdk/src/visual.hg
+++ b/gdk/src/visual.hg
@@ -71,9 +71,12 @@ public:
 
    _WRAP_METHOD(VisualType get_visual_type() const, gdk_visual_get_visual_type)
    _WRAP_METHOD(int get_depth() const, gdk_visual_get_depth)
-   _WRAP_METHOD(ByteOrder get_byte_order(), gdk_visual_get_byte_order)
-   _WRAP_METHOD(int get_colormap_size() const, gdk_visual_get_colormap_size)
-   _WRAP_METHOD(int get_bits_per_rgb() const, gdk_visual_get_bits_per_rgb)
+   _WRAP_METHOD(ByteOrder get_byte_order(), gdk_visual_get_byte_order,
+     deprecated "This information is not useful.")
+   _WRAP_METHOD(int get_colormap_size() const, gdk_visual_get_colormap_size,
+     deprecated "This information is not useful, since GDK does not provide APIs to operate on colormaps.")
+   _WRAP_METHOD(int get_bits_per_rgb() const, gdk_visual_get_bits_per_rgb,
+     deprecated "Use get_red_pixel_details() and its variants to learn about the pixel layout of TrueColor 
and DirectColor visuals.")
    _WRAP_METHOD(void get_red_pixel_details(guint32& mask, int& shift, int& precision) const, 
gdk_visual_get_red_pixel_details)
    _WRAP_METHOD(void get_green_pixel_details(guint32& mask, int& shift, int& precision) const, 
gdk_visual_get_green_pixel_details)
    _WRAP_METHOD(void get_blue_pixel_details(guint32& mask, int& shift, int& precision) const, 
gdk_visual_get_blue_pixel_details)