From 2635ef3607adc473fb0e65b7d7b617feb7d74920 Mon Sep 17 00:00:00 2001
From: Daemonratte <daemonratte@daemonratte.net>
Date: Sun, 10 May 2026 10:38:36 +0200
Subject: [PATCH] gdk: document client message filter callback scope

---
 gdk/gdkdisplay.h | 9 +++++++++
 gdk/gdkevents.h  | 9 +++++++++
 2 files changed, 18 insertions(+)

diff --git a/gdk/gdkdisplay.h b/gdk/gdkdisplay.h
index 99631cdb0..fcc0ec9c4 100644
--- a/gdk/gdkdisplay.h
+++ b/gdk/gdkdisplay.h
@@ -166,6 +166,15 @@ GdkEvent* gdk_display_peek_event (GdkDisplay     *display);
 void      gdk_display_put_event  (GdkDisplay     *display,
 				  const GdkEvent *event);
 
+/**
+ * gdk_display_add_client_message_filter:
+ * @display: a #GdkDisplay for which this message filter applies.
+ * @message_type: the type of ClientMessage events to receive.
+ * @func: (scope forever): the function to call to process the event.
+ * @data: user data to pass to @func.
+ *
+ * Adds a filter to be called when X ClientMessage events are received.
+ */
 void gdk_display_add_client_message_filter (GdkDisplay   *display,
 					    GdkAtom       message_type,
 					    GdkFilterFunc func,
diff --git a/gdk/gdkevents.h b/gdk/gdkevents.h
index be7535b9b..707700cbb 100644
--- a/gdk/gdkevents.h
+++ b/gdk/gdkevents.h
@@ -553,6 +553,15 @@ void	  gdk_set_show_events		(gboolean	 show_events);
 gboolean  gdk_get_show_events		(void);
 
 #ifndef GDK_MULTIHEAD_SAFE
+/**
+ * gdk_add_client_message_filter:
+ * @message_type: the type of ClientMessage events to receive.
+ * @func: (scope forever): the function to call to process the event.
+ * @data: user data to pass to @func.
+ *
+ * Adds a filter to the default display to be called when X ClientMessage
+ * events are received. See gdk_display_add_client_message_filter().
+ */
 void gdk_add_client_message_filter (GdkAtom       message_type,
 				    GdkFilterFunc func,
 				    gpointer      data);