[gtk+] Deprecate gdk_visual_get_colormap_size

[Matthias Clasen <matthiasc src gnome org>]

commit f06fc8d378521866c19d4e52b3b97addb750805d
Author: Matthias Clasen <mclasen redhat com>
Date:   Sat Mar 26 15:15:28 2016 -0400

    Deprecate gdk_visual_get_colormap_size
    
    Since we don't have API for colormaps anymore, this is not
    a useful function.

 gdk/gdkvisual.c |    7 +++++++
 gdk/gdkvisual.h |    2 +-
 2 files changed, 8 insertions(+), 1 deletions(-)
---
diff --git a/gdk/gdkvisual.c b/gdk/gdkvisual.c
index 82305fc..efdeac7 100644
--- a/gdk/gdkvisual.c
+++ b/gdk/gdkvisual.c
@@ -302,6 +302,7 @@ gdk_visual_get_depth (GdkVisual *visual)
  * @visual: A #GdkVisual.
  *
  * Returns the byte order of this visual.
+ *
  * The information returned by this function is only relevant
  * when working with XImages, and not all backends return
  * meaningful information for this.
@@ -326,9 +327,14 @@ gdk_visual_get_byte_order (GdkVisual *visual)
  *
  * Returns the size of a colormap for this visual.
  *
+ * You have to use platform-specific APIs to manipulate colormaps.
+ *
  * Returns: The size of a colormap that is suitable for @visual.
  *
  * Since: 2.22
+ *
+ * Deprecated: 3.22: This information is not useful, since GDK does not
+ *     provide APIs to operate on colormaps.
  */
 gint
 gdk_visual_get_colormap_size (GdkVisual *visual)
@@ -343,6 +349,7 @@ gdk_visual_get_colormap_size (GdkVisual *visual)
  * @visual: a #GdkVisual
  *
  * Returns the number of significant bits per red, green and blue value.
+ *
  * Not all GDK backend provide a meaningful value for this function.
  *
  * Returns: The number of significant bits per color value for @visual.
diff --git a/gdk/gdkvisual.h b/gdk/gdkvisual.h
index 84337aa..a401f1f 100644
--- a/gdk/gdkvisual.h
+++ b/gdk/gdkvisual.h
@@ -117,7 +117,7 @@ GDK_AVAILABLE_IN_ALL
 gint          gdk_visual_get_depth               (GdkVisual *visual);
 GDK_DEPRECATED_IN_3_22
 GdkByteOrder  gdk_visual_get_byte_order          (GdkVisual *visual);
-GDK_AVAILABLE_IN_ALL
+GDK_DEPRECATED_IN_3_22
 gint          gdk_visual_get_colormap_size       (GdkVisual *visual);
 GDK_DEPRECATED_IN_3_22
 gint          gdk_visual_get_bits_per_rgb        (GdkVisual *visual);