correcting and expanding content of statusbar help text

1 files changed, 21 insertions, 12 deletions

diff --git a/docs/help/in/statusbar.in b/docs/help/in/statusbar.in
index ac475dd5..7fff7fb8 100644
--- a/docs/help/in/statusbar.in
+++ b/docs/help/in/statusbar.in
@@ -5,22 +5,31 @@
 
 %9Parameters:%9
 
-    ENABLE:       Enables the statusbar.
-    DISABLE:      Disabled the statusbar.
+    ENABLE:       Adds a statusbar to the list of statusbars.
+    DISABLE:      Removes a statusbar from the list.
     RESET:        Restores the default statusbar configuration.
-    TYPE:         Identifies the type of statusbar.
-    PLACEMENT:    Identifies the placement of the statusbar.
-    POSITION:     Identifies the position of the statusbar.
-    VISIBLE:      Identifies the visibility of the statusbar.
-    ADD:          Adds a statusbar into the configuration.
-    REMOVE:       Removes a statusbar from the configuration.
-
-    The name of the statusbar; if no argument is given, the list of statusbars
-    will be displayed.
+    TYPE:         Refers to the type of statusbar, for each split window
+                  or only for the current root screen.
+    PLACEMENT:    Refers to the placement of the statusbar, either at the
+                  top or the bottom of the screen.
+    POSITION:     Refers to the position of the statusbar. Represented as
+                  an unsigned integer, with 0 implying the first position.
+    VISIBLE:      Refers to the visibility of the statusbar or item. If set
+                  to always it is visible on all screens, otherwise if set
+                  to inactive or active then it is only visible on inactive
+                  or active screens, respectively.
+    ADD:          Adds an item to the specified statusbar. It can be set to
+                  appear before/after another item and left/right aligned
+                  to a specified position on the screen.
+    REMOVE:       Removes an item from the specified statusbar.
+
+    Where name refers to the name of the statusbar; if no argument is
+    given, the entire list of statusbars will be displayed.
 
 %9Description:%9
 
-    Modified the attributes of the statusbar.
+    Allows adjustment of the attributes and items of a statusbar, as well
+    as where it is located and whether or not it is currently visible.
 
 %9Examples:%9