From: Michael Stapelberg <michael@stapelberg.de>
Date: Sun, 28 Aug 2011 12:54:58 +0000 (+0200)
Subject: docs/userguide: document force_focus_wrapping config directive
X-Git-Tag: 4.0.2~9^2
X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=c846ff272f851375273407d4d03dae545b566482;p=i3%2Fi3

docs/userguide: document force_focus_wrapping config directive
---

diff --git a/docs/userguide b/docs/userguide
index 97a9ab06..6971c9ed 100644
--- a/docs/userguide
+++ b/docs/userguide
@@ -665,6 +665,29 @@ popup_during_fullscreen <ignore|leave_fullscreen>
 popup_during_fullscreen ignore
 ------------------------------
 
+=== Focus wrapping
+
+When being in a tabbed or stacked container, the first container will be
+focused when you use +focus down+ on the last container -- the focus wraps. If
+however there is another stacked/tabbed container in that direction, focus will
+be set on that container. This is the default behaviour so you can navigate to
+all your windows without having to use +focus parent+.
+
+If you want the focus to *always* wrap and you are aware of using +focus
+parent+ to switch to different containers, you can use the
++force_focus_wrapping+ configuration directive. After enabling it, the focus
+will always wrap.
+
+*Syntax*:
+-----------------------------
+force_focus_wrapping <yes|no>
+-----------------------------
+
+*Example*:
+------------------------
+force_focus_wrapping yes
+------------------------
+
 == List of commands
 
 === Splitting containers