summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMatthias Clasen <mclasen@redhat.com>2023-05-14 17:34:35 -0400
committerMatthias Clasen <mclasen@redhat.com>2023-05-15 00:20:24 -0400
commit250a5c0dfddf1660cdaf21b92e4cb1376a07932c (patch)
treefe3991c2fc47f9470894e0729f6d995f5c0de6ba
parentaf3ceb57551ee410be1641e6c51281d2aef1a978 (diff)
downloadgtk+-250a5c0dfddf1660cdaf21b92e4cb1376a07932c.tar.gz
Deprecate gdk_wayland_toplevel_unexport_handle
It doesn't do anything anymore, and is no longer used internally. The replacement is gdk_wayland_toplevel_drop_exported_handled().
-rw-r--r--gdk/wayland/gdktoplevel-wayland.c13
-rw-r--r--gdk/wayland/gdkwaylandtoplevel.h2
2 files changed, 14 insertions, 1 deletions
diff --git a/gdk/wayland/gdktoplevel-wayland.c b/gdk/wayland/gdktoplevel-wayland.c
index bd3738ff3d..efeb857b21 100644
--- a/gdk/wayland/gdktoplevel-wayland.c
+++ b/gdk/wayland/gdktoplevel-wayland.c
@@ -2502,6 +2502,12 @@ export_handle_done (GObject *source,
* from another surface as transient for this one, see
* [method@GdkWayland.WaylandToplevel.set_transient_for_exported].
*
+ * Before 4.12, this API could not safely be used multiple times,
+ * since there was no reference counting for handles. Starting with
+ * 4.12, every call to this function obtains a new handle, and every
+ * call to [method@GdkWayland.WaylandToplevel.drop_exported_handle] drops
+ * just the handle that it is given.
+ *
* Note that this API depends on an unstable Wayland protocol,
* and thus may require changes in the future.
*
@@ -2538,8 +2544,15 @@ gdk_wayland_toplevel_export_handle (GdkToplevel *toplevel,
* It is an error to call this function on a surface that
* does not have a handle.
*
+ * Since 4.12, this function does nothing. Use
+ * [method@GdkWayland.WaylandToplevel.drop_exported_handle] instead to drop a
+ * handle that was obtained with [method@GdkWayland.WaylandToplevel.export_handle].
+ *
* Note that this API depends on an unstable Wayland protocol,
* and thus may require changes in the future.
+ *
+ * Deprecated: 4.12: Use [method@GdkWayland.WaylandToplevel.drop_exported_handle]
+ * instead, this function does nothing
*/
void
gdk_wayland_toplevel_unexport_handle (GdkToplevel *toplevel)
diff --git a/gdk/wayland/gdkwaylandtoplevel.h b/gdk/wayland/gdkwaylandtoplevel.h
index bb7abe5976..0240f9d19f 100644
--- a/gdk/wayland/gdkwaylandtoplevel.h
+++ b/gdk/wayland/gdkwaylandtoplevel.h
@@ -52,7 +52,7 @@ gboolean gdk_wayland_toplevel_export_handle (GdkToplevel
gpointer user_data,
GDestroyNotify destroy_func);
-GDK_AVAILABLE_IN_ALL
+GDK_DEPRECATED_IN_4_12_FOR(gdk_wayland_toplevel_drop_exported_handle)
void gdk_wayland_toplevel_unexport_handle (GdkToplevel *toplevel);
GDK_AVAILABLE_IN_4_12