[gtk: 2/10] gdk/win32: deprecate gdk_win32_surface_is_win32

[Luca Bacci <lbacci src gnome org>]

commit 180dd5fb7f53f48b2a3fef57b19f1ac2fb4074a6
Author: Marc-André Lureau <marcandre lureau redhat com>
Date:   Tue Aug 23 15:32:55 2022 +0400

    gdk/win32: deprecate gdk_win32_surface_is_win32
    
    The function isn't used by Gtk itself anymore, and does not help much.
    It creates extra issues for bindings, as it doesn't fit well with code
    doing the same job for other objects.
    
    Signed-off-by: Marc-André Lureau <marcandre lureau redhat com>

 gdk/win32/gdksurface-win32.c | 12 ++++++++++--
 gdk/win32/gdkwin32misc.h     |  5 ++---
 2 files changed, 12 insertions(+), 5 deletions(-)
---
diff --git a/gdk/win32/gdksurface-win32.c b/gdk/win32/gdksurface-win32.c
index 6fc15f3815..e461b0e916 100644
--- a/gdk/win32/gdksurface-win32.c
+++ b/gdk/win32/gdksurface-win32.c
@@ -4242,10 +4242,18 @@ gdk_win32_surface_lookup_for_display (GdkDisplay *display,
   return (GdkSurface*) gdk_win32_handle_table_lookup (anid);
 }
 
+/**
+ * gdk_win32_surface_is_win32:
+ * @surface: a `GdkSurface`
+ *
+ * Returns: %TRUE if the @surface is a win32 implemented surface.
+ *
+ * Deprecated: 4.8: Use `GDK_IS_WIN32_SURFACE` instead.
+ */
 gboolean
-gdk_win32_surface_is_win32 (GdkSurface *window)
+gdk_win32_surface_is_win32 (GdkSurface *surface)
 {
-  return GDK_IS_WIN32_SURFACE (window);
+  return GDK_IS_WIN32_SURFACE (surface);
 }
 
 static gboolean
diff --git a/gdk/win32/gdkwin32misc.h b/gdk/win32/gdkwin32misc.h
index 3582e81572..bfa356a453 100644
--- a/gdk/win32/gdkwin32misc.h
+++ b/gdk/win32/gdkwin32misc.h
@@ -68,9 +68,8 @@ G_BEGIN_DECLS
 #define XBUTTON2 2
 #endif
 
-/* Return true if the GdkSurface is a win32 implemented window */
-GDK_AVAILABLE_IN_ALL
-gboolean      gdk_win32_surface_is_win32 (GdkSurface *window);
+GDK_DEPRECATED_IN_4_8_FOR(GDK_IS_WIN32_SURFACE)
+gboolean      gdk_win32_surface_is_win32 (GdkSurface *surface);
 GDK_AVAILABLE_IN_ALL
 HWND          gdk_win32_surface_get_impl_hwnd (GdkSurface *window);