From f8a30ddfc1d77fc37a0acf14b4929c0ffaa3cea9 Mon Sep 17 00:00:00 2001
From: Benjamin Otte <otte@redhat.com>
Date: Fri, 9 Aug 2024 07:29:58 +0200
Subject: [PATCH] gdk: Deprecate gdk_surface_set_opaque_region()

---
 gdk/gdksurface.c | 3 +++
 gdk/gdksurface.h | 2 +-
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/gdk/gdksurface.c b/gdk/gdksurface.c
index ddde1fd427..bb0a7aef3e 100644
--- a/gdk/gdksurface.c
+++ b/gdk/gdksurface.c
@@ -2696,6 +2696,9 @@ gdk_surface_update_opaque_region (GdkSurface *self)
  * is opaque, as we know where the opaque regions are. If your surface
  * background is not opaque, please update this property in your
  * [GtkWidgetClass.css_changed](../gtk4/vfunc.Widget.css_changed.html) handler.
+ *
+ * Deprecated: 4.16: GDK can figure out the opaque parts of a window itself
+ *   by inspecting the contents that are drawn.
  */
 void
 gdk_surface_set_opaque_region (GdkSurface      *surface,
diff --git a/gdk/gdksurface.h b/gdk/gdksurface.h
index 5c8025c38f..143e4a3780 100644
--- a/gdk/gdksurface.h
+++ b/gdk/gdksurface.h
@@ -125,7 +125,7 @@ void       gdk_surface_request_layout     (GdkSurface       *surface);
 GDK_AVAILABLE_IN_ALL
 GdkFrameClock* gdk_surface_get_frame_clock      (GdkSurface     *surface);
 
-GDK_AVAILABLE_IN_ALL
+GDK_DEPRECATED_IN_4_16
 void       gdk_surface_set_opaque_region        (GdkSurface      *surface,
                                                  cairo_region_t *region);