From 8cfd96d6214886184e2342da5132af1db0f72d6a Mon Sep 17 00:00:00 2001
From: Jos Dehaes <jos.dehaes@gmail.com>
Date: Wed, 15 Apr 2026 14:37:29 +0200
Subject: [PATCH] docs: document raiseOnFocusDelay

Add the new option to labwc-config(5) and the example rc.xml.all.
---
 docs/labwc-config.5.scd | 7 +++++++
 docs/rc.xml.all         | 2 ++
 2 files changed, 9 insertions(+)

diff --git a/docs/labwc-config.5.scd b/docs/labwc-config.5.scd
index ac94d54c..2865de04 100644
--- a/docs/labwc-config.5.scd
+++ b/docs/labwc-config.5.scd
@@ -493,6 +493,13 @@ this is for compatibility with Openbox.
 *<focus><raiseOnFocus>* [yes|no]
 	Raise window to top when focused. Default is no.
 
+*<focus><raiseOnFocusDelay>* [milliseconds]
+	When raiseOnFocus is enabled, delay the actual raise by this many
+	milliseconds. Default is 0 (raise immediately). A subsequent focus
+	change before the timer elapses restarts or cancels the pending raise.
+	Useful together with followMouse to avoid brief passes of the cursor
+	stacking up z-order changes.
+
 ## WINDOW SNAPPING
 
 Windows may be "snapped" to an edge or user-defined region of an output when
diff --git a/docs/rc.xml.all b/docs/rc.xml.all
index 6d543b46..e3d32ad1 100644
--- a/docs/rc.xml.all
+++ b/docs/rc.xml.all
@@ -158,6 +158,8 @@
     <followMouse>no</followMouse>
     <followMouseRequiresMovement>yes</followMouseRequiresMovement>
     <raiseOnFocus>no</raiseOnFocus>
+    <!-- Delay (ms) before applying raise-on-focus. 0 = immediate. -->
+    <raiseOnFocusDelay>0</raiseOnFocusDelay>
   </focus>
 
   <snapping>