From 6907dc2c23c4baea051061264a2954042cd187d9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Thomas=20L=C3=BCbking?= <thomas.luebking@gmail.com>
Date: Sun, 26 Jun 2016 12:36:27 +0200
Subject: document FocusProtection feature

---
 doc/asciidoc/fluxbox-apps.txt | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/doc/asciidoc/fluxbox-apps.txt b/doc/asciidoc/fluxbox-apps.txt
index 1a12184..c4c9050 100644
--- a/doc/asciidoc/fluxbox-apps.txt
+++ b/doc/asciidoc/fluxbox-apps.txt
@@ -159,9 +159,27 @@ Button, Close Button, Menu Button, Sticky Button, Shade Button, External Tabs, F
     Whether the window has tabs enabled.
 
 *[FocusNewWindow]* {'bool'}::
+    *DEPRECATED!* Please use FocusProtection "Gain" or "Refuse" instead.;;
     If enabled, a new window will grab X focus as soon as it is opened.
     If disabled, a new window will not grab X focus as soon as it is opened.
 
+*[FocusProtection]* {'value' [,'value' [, ...]] }::
+    Comma separated list of focus controlling flags. 'value' may be:;;
++
+--
+    *None*;;
+        Regular behavior
+    *Gain*;;
+        A new window will grab X focus as soon as it is opened.
+    *Refuse*;;
+        A new window will not grab X focus as soon as it is opened.
+    *Deny*;;
+        The window is not allowed to claim focus while it is opened.
+    *Lock*;;
+        No window is allowed to claim the focus while this window has it.
+--
+    Please notice that technically, windows may still obtain the focus which is then however reverted by the WM. In case you're very unlucky, a key event may thus still go to the wrong window.
+
 *[FocusHidden]* {'bool'}::
     If enabled, the window will not appear in 'NextWindow'/'PrevWindow' lists.
 
-- 
cgit v0.11.2