From ce0074b034b2b89afd47a344824fa24e1857329f Mon Sep 17 00:00:00 2001
From: Matthias Clasen <mclasen@redhat.com>
Date: Sat, 26 Mar 2016 15:06:10 -0400
Subject: [PATCH] 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 e3c5b6f9c1..82305fc90a 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 3f603a3989..84337aaddc 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);