Add documentation for the workspace_bar option

diff --git a/docs/userguide b/docs/userguide
index f4a27743cac762b5c40b4ee41e05e77639dffb37..c88219617c67f0df0932abf71dc58662d3d84568 100644 (file)
--- a/docs/userguide
+++ b/docs/userguide
@@ -527,6 +527,26 @@ focus_follows_mouse <yes|no>
 focus_follows_mouse no
 ----------------------
 
+=== Internal workspace bar
+
+The internal workspace bar (the thing at the bottom of your screen) is very
+simple -- it does not provide a way to display custom text and it does not
+offer advanced customization features. This is intended because we do not
+want to duplicate functionality of tools like +dzen2+, +xmobar+ and so on
+(they render bars, we manage windows). Instead, there is an option which will
+turn off the internal bar completely, so that you can use a separate program to
+display it (see +i3-wsbar+, a sample implementation of such a program):
+
+*Syntax*:
+----------------------
+workspace_bar <yes|no>
+----------------------
+
+*Examples*:
+----------------
+workspace_bar no
+----------------
+
 == List of commands
 
 === Manipulating layout