docs/userguide: document the output bar option

diff --git a/docs/userguide b/docs/userguide
index 3c0c68564a7b2db321c4178fdb4f50be3c02a643..135c6bae3e78804d5c8c7bd0b0236ac71715e221 100644 (file)
--- a/docs/userguide
+++ b/docs/userguide
@@ -547,7 +547,7 @@ exec_always command
 
 *Examples*:
 --------------------------------
-exec i3status | i3bar -d
+exec chromium
 exec_always ~/my_script.sh
 --------------------------------
 
@@ -844,6 +844,36 @@ position <top|bottom>
 position top
 ---------------------
 
+=== Output(s)
+
+You can restrict i3bar to one or more outputs (monitors). The default is to
+handle all outputs. Restricting the outputs is useful for using different
+options for different outputs by using multiple 'bar' blocks.
+
+*Syntax*:
+---------------
+output <output>
+---------------
+
+*Example*:
+-------------------------------
+# big monitor: everything
+bar {
+       output HDMI2
+       status_command i3status
+}
+
+# laptop monitor: bright colors and i3status with less modules.
+bar {
+       output LVDS1
+       status_command i3status --config ~/.i3status-small.conf
+       colors {
+               background #000000
+               statusline #ffffff
+       }
+}
+-------------------------------
+
 === Tray output
 
 i3bar by default provides a system tray area where programs such as