From 0788f43db757bf2ee301af22cf80abb85477f505 Mon Sep 17 00:00:00 2001 From: =?utf8?q?Ingo=20B=C3=BCrk?= Date: Wed, 1 Apr 2015 13:59:24 +0200 Subject: [PATCH] Updates userguide for 'no_focus ' (#1416) --- docs/userguide | 27 +++++++++++++++++++++++++-- 1 file changed, 25 insertions(+), 2 deletions(-) diff --git a/docs/userguide b/docs/userguide index 2e42493c..98629761 100644 --- a/docs/userguide +++ b/docs/userguide @@ -589,6 +589,27 @@ for_window [title="x200: ~/work"] floating enable The valid criteria are the same as those for commands, see <>. +=== Don't focus window upon opening + +[[no_focus]] + +When a new window appears, it will be focused. The +no_focus+ directive allows preventing +this from happening and can be used in combination with <>. + +Note that this does not apply to all cases, e.g., when feeding data into a running application +causing it to request being focused. To configure the behavior in such cases, refer to +<>. + +*Syntax*: +------------------- +no_focus +------------------- + +*Example*: +------------------------------- +no_focus [window_role="pop-up"] +------------------------------- + === Variables As you learned in the section about keyboard bindings, you will have @@ -983,11 +1004,13 @@ force_display_urgency_hint 500 ms === Focus on window activation +[[focus_on_window_activation]] + If a window is activated, e.g., via +google-chrome www.google.com+, it may request to take focus. Since this may not preferable, different reactions can be configured. -Note that this does not apply to any window that is opened, i.e., typically opening -an application will focus that window independent of this configuration. +Note that this may not affect windows that are being opened. To prevent new windows +from being focused, see <>. *Syntax*: ---------------------------------------------------- -- 2.39.5