update docs/userguide

[i3/i3.github.io] / docs / 4.0 / userguide.html

diff --git a/docs/4.0/userguide.html b/docs/4.0/userguide.html
index 88b148aa9f0e5a50e99fbd4aa893aea6ed9e9735..85e77eb2a4dc3fb1905d358b69fd1002d99b58c0 100644 (file)
--- a/docs/4.0/userguide.html
+++ b/docs/4.0/userguide.html
@@ -755,6 +755,28 @@ Leave fullscreen mode. This is the default.
 <pre><tt>popup_during_fullscreen ignore</tt></pre>\r
 </div></div>\r
 </div>\r
+<div class="sect2">\r
+<h3 id="_focus_wrapping">4.17. Focus wrapping</h3>\r
+<div class="paragraph"><p>When being in a tabbed or stacked container, the first container will be\r
+focused when you use <tt>focus down</tt> on the last container&#8201;&#8212;&#8201;the focus wraps. If\r
+however there is another stacked/tabbed container in that direction, focus will\r
+be set on that container. This is the default behaviour so you can navigate to\r
+all your windows without having to use <tt>focus parent</tt>.</p></div>\r
+<div class="paragraph"><p>If you want the focus to <strong>always</strong> wrap and you are aware of using <tt>focus\r
+parent</tt> to switch to different containers, you can use the\r
+<tt>force_focus_wrapping</tt> configuration directive. After enabling it, the focus\r
+will always wrap.</p></div>\r
+<div class="paragraph"><p><strong>Syntax</strong>:</p></div>\r
+<div class="listingblock">\r
+<div class="content">\r
+<pre><tt>force_focus_wrapping &lt;yes|no&gt;</tt></pre>\r
+</div></div>\r
+<div class="paragraph"><p><strong>Example</strong>:</p></div>\r
+<div class="listingblock">\r
+<div class="content">\r
+<pre><tt>force_focus_wrapping yes</tt></pre>\r
+</div></div>\r
+</div>\r
 </div>\r
 </div>\r
 <div class="sect1">\r