[gtk+] Deprecate gdk_visual_get_byte_order

[Matthias Clasen <matthiasc src gnome org>]

commit ce0074b034b2b89afd47a344824fa24e1857329f
Author: Matthias Clasen <mclasen redhat com>
Date:   Sat Mar 26 15:06:10 2016 -0400

    Deprecate gdk_visual_get_byte_order
    
    This function is only useful when working with XImages,
    and is not meaningfully implemented in other backends.

 gdk/gdkvisual.c |    8 +++++++-
 gdk/gdkvisual.h |    2 +-
 2 files changed, 8 insertions(+), 2 deletions(-)
---
diff --git a/gdk/gdkvisual.c b/gdk/gdkvisual.c
index e3c5b6f..82305fc 100644
--- a/gdk/gdkvisual.c
+++ b/gdk/gdkvisual.c
@@ -302,10 +302,15 @@ 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.
  *
  * Returns: A #GdkByteOrder stating the byte order of @visual.
  *
  * Since: 2.22
+ *
+ * Deprecated: 3.22: This information is not useful
  */
 GdkByteOrder
 gdk_visual_get_byte_order (GdkVisual *visual)
@@ -344,7 +349,8 @@ gdk_visual_get_colormap_size (GdkVisual *visual)
  *
  * Since: 2.22
  *
- * Deprecated: 3.22. Use gdk_visual_get_red_pixel_details() and its variants
+ * Deprecated: 3.22. Use gdk_visual_get_red_pixel_details() and its variants to
+ *     learn about the pixel layout of TrueColor and DirectColor visuals
  */
 gint
 gdk_visual_get_bits_per_rgb (GdkVisual *visual)
diff --git a/gdk/gdkvisual.h b/gdk/gdkvisual.h
index 3f603a3..84337aa 100644
--- a/gdk/gdkvisual.h
+++ b/gdk/gdkvisual.h
@@ -115,7 +115,7 @@ GDK_AVAILABLE_IN_ALL
 GdkVisualType gdk_visual_get_visual_type         (GdkVisual *visual);
 GDK_AVAILABLE_IN_ALL
 gint          gdk_visual_get_depth               (GdkVisual *visual);
-GDK_AVAILABLE_IN_ALL
+GDK_DEPRECATED_IN_3_22
 GdkByteOrder  gdk_visual_get_byte_order          (GdkVisual *visual);
 GDK_AVAILABLE_IN_ALL
 gint          gdk_visual_get_colormap_size       (GdkVisual *visual);