M doc/asciidoc/fluxbox-apps.txt → doc/asciidoc/fluxbox-apps.txt

@@ -159,8 +159,26 @@ *[Tab]* {'bool'}::
     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.