document FocusProtection feature

This commit is contained in:
Thomas Lübking 2016-06-26 12:36:27 +02:00 committed by Mathias Gumz
parent 07d8fbfba8
commit 6907dc2c23

View file

@ -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.