document FocusProtection feature

1 files changed, 18 insertions, 0 deletions

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.