From 646c76adea389609ec41d0c20b44a584cbf98d41 Mon Sep 17 00:00:00 2001
From: "Enrico Weigelt, metux IT consult" <info@metux.net>
Date: Thu, 22 May 2025 20:13:36 +0200
Subject: [PATCH] dix: unexport and document ClientSignalAll()

Not used by any external drivers, so no need to keep it exported.

Signed-off-by: Enrico Weigelt, metux IT consult <info@metux.net>
---
 dix/dix_priv.h | 17 +++++++++++++++++
 include/dix.h  |  8 --------
 2 files changed, 17 insertions(+), 8 deletions(-)

diff --git a/dix/dix_priv.h b/dix/dix_priv.h
index ec5954486..9094452d5 100644
--- a/dix/dix_priv.h
+++ b/dix/dix_priv.h
@@ -321,6 +321,8 @@ ClientPtr NextAvailableClient(void *ospriv);
 void MarkClientException(ClientPtr pClient)
     _X_ATTRIBUTE_NONNULL_ARG(1);
 
+typedef Bool (*ClientSleepProcPtr) (ClientPtr client, void *closure);
+
 /*
  * @brief put a client to sleep
  *
@@ -340,4 +342,19 @@ Bool ClientSleep(ClientPtr pClient, ClientSleepProcPtr func, void *closure)
 Bool dixClientSignal(ClientPtr pClient)
     _X_ATTRIBUTE_NONNULL_ARG(1);
 
+#define CLIENT_SIGNAL_ANY ((void *)-1)
+/*
+ * @brief signal to all sleeping clients matching client, func, closure
+ *
+ * If any of the client, func and closure parameters may be CLIENT_SIGNAL_ANY,
+ * so those will be matching any value
+ *
+ * @param pClient   match for client
+ * @param func      match for callback function
+ * @param closure   match for callback closure
+ * @return number of matched / queued clients
+ */
+int ClientSignalAll(ClientPtr pClient, ClientSleepProcPtr func, void *closure)
+    _X_ATTRIBUTE_NONNULL_ARG(1,2);
+
 #endif /* _XSERVER_DIX_PRIV_H */
diff --git a/include/dix.h b/include/dix.h
index efeeca709..46863efff 100644
--- a/include/dix.h
+++ b/include/dix.h
@@ -216,14 +216,6 @@ extern _X_EXPORT Bool QueueWorkProc(Bool (*function)(ClientPtr clientUnused,
                                     ClientPtr client,
                                     void *closure);
 
-typedef Bool (*ClientSleepProcPtr) (ClientPtr client,
-                                    void *closure);
-
-#define CLIENT_SIGNAL_ANY ((void *)-1)
-extern _X_EXPORT int ClientSignalAll(ClientPtr /*client*/,
-                                     ClientSleepProcPtr /*function*/,
-                                     void * /*closure*/);
-
 extern _X_EXPORT void ClientWakeup(ClientPtr /*client */ );
 
 extern _X_EXPORT Bool ClientIsAsleep(ClientPtr /*client */ );