From f06fc8d378521866c19d4e52b3b97addb750805d Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Sat, 26 Mar 2016 15:15:28 -0400 Subject: [PATCH] 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 deletion(-) diff --git a/gdk/gdkvisual.c b/gdk/gdkvisual.c index 82305fc90a..efdeac7302 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 84337aaddc..a401f1f489 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);