Add documentation for the new focus follows mouse-option

diff --git a/docs/userguide b/docs/userguide
index 108060309187a582ac0ee3c69ea8366589eb9448..63f8e8acaa83560c21edbfdcc811c8b8d8a3c73e 100644 (file)
--- a/docs/userguide
+++ b/docs/userguide
@@ -462,6 +462,24 @@ ipc-socket /tmp/i3-ipc.sock
 You can then use the i3-msg command to perform any command listed in the next
 section.
 
+=== Disable focus follows mouse
+
+If you have a setup where your mouse usually is in your way (like a touchpad
+on your laptop which you do not want to disable completely), you might want
+to disable focus follows mouse and control focus only by using your keyboard.
+The mouse will still be useful inside the currently active window (for example
+to click on links in your browser window).
+
+*Syntax*:
+----------------------------
+focus_follows_mouse <yes|no>
+----------------------------
+
+*Examples*:
+----------------------
+focus_follows_mouse no
+----------------------
+
 == List of commands
 
 === Manipulating layout