man pages: minor language and style changes

diff --git a/docs/labwc-actions.5.scd b/docs/labwc-actions.5.scd
index e1cbc44e8fab597b41beb1ad6f66b139e220c70a..9a7c13499b2a02654c8e1afdc9772163839b8c95 100644 (file)
--- a/docs/labwc-actions.5.scd
+++ b/docs/labwc-actions.5.scd
@@ -6,10 +6,10 @@ labwc - actions
 
 # ACTIONS
 
-Actions are used in keyboard bindings.
+Actions are used in menus and keyboard/mouse bindings.
 
 *<action name="Close">*
-       Close top-most view.
+       Close top-most window.
 
 *<action name="Execute"><command>*
        Execute command.  Note that in the interest of backward compatibility,
@@ -32,14 +32,14 @@ Actions are used in keyboard bindings.
        Begin interactive move of window under cursor
 
 *<action name="MoveToEdge"><direction>*
-       Move view to edge of outputs. Understands directions "left", "up",
+       Move window to edge of outputs. Understands directions "left", "up",
        "right" and "down".
 
 *<action name="Resize">*
        Begin interactive resize of window under cursor
 
 *<action name="SnapToEdge"><direction>*
-       Resize view to fill half the output in the given direction. Supports
+       Resize window to fill half the output in the given direction. Supports
        directions "left", "up", "right", "down" and "center".
 
 *<action name="NextWindow">*

diff --git a/docs/labwc-menu.5.scd b/docs/labwc-menu.5.scd
index 905cc53b4b311da6caaf28345cf083cdc52c0d4c..716e00b89851319ab6ead8a3f7e3f6648e0ac384 100644 (file)
--- a/docs/labwc-menu.5.scd
+++ b/docs/labwc-menu.5.scd
@@ -17,15 +17,15 @@ A menu file must be entirely enclosed within <openbox_menu> and
 ```
 <menu id="" label="">
 
-  <!-- This is a menu item, such as a program -->
+  <!-- A menu entry with an action, for example to execute an application -->
   <item label="">
     <action></action>
   </item>
 
-  <!-- This links to a submenu defined else where -->
+  <!-- A submenu defined elsewhere -->
   <menu id="" />
 
-  <!-- This links to a submenu defined inline -->
+  <!-- An inline submenu -->
   <menu id="" label="">
     ...some content...
   </menu>
@@ -38,7 +38,8 @@ A menu file must be entirely enclosed within <openbox_menu> and
        This id is used to refer to the menu in a ShowMenu action.
 
 *menu.label*
-       The title of the menu, shown in its parent.
+       The title of the menu, shown in its parent. A label must be given when
+       defining a menu.
 
 *menu.item.label*
        The visible name of the menu item.

diff --git a/docs/rc.xml.all b/docs/rc.xml.all
index 663dd93a8a21865a0f798236335fb0d49425f045..5acc5bcc62fe2e5f57a2e54cc0bd8557bb0b987b 100644 (file)
--- a/docs/rc.xml.all
+++ b/docs/rc.xml.all
@@ -14,9 +14,7 @@
     <cycleViewPreview>no</cycleViewPreview>
   </core>
 
-  <!--
-    <font><theme> can be defined without an attribute to set all places
-  -->
+  <!-- <font><theme> can be defined without an attribute to set all places -->
   <theme>
     <name></name>
     <cornerRadius>8</cornerRadius>
@@ -35,9 +33,7 @@
     <raiseOnFocus>no</raiseOnFocus>
   </focus>
 
-  <!--
-    Set range to 0 to disable window snapping completely
-  -->
+  <!-- Set range to 0 to disable window snapping completely -->
   <snapping>
     <range>1</range>
     <topMaximize>yes</topMaximize>