From c8dd19caa3a75f534c4d24da6f034c1ec05b8471 Mon Sep 17 00:00:00 2001
From: Johan Malm <jgm323@gmail.com>
Date: Tue, 31 May 2022 22:01:26 +0100
Subject: [PATCH] man pages: minor language and style changes

---
 docs/labwc-actions.5.scd | 8 ++++----
 docs/labwc-menu.5.scd    | 9 +++++----
 docs/rc.xml.all          | 8 ++------
 3 files changed, 11 insertions(+), 14 deletions(-)

diff --git a/docs/labwc-actions.5.scd b/docs/labwc-actions.5.scd
index e1cbc44e..9a7c1349 100644
--- 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 905cc53b..716e00b8 100644
--- 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 663dd93a..5acc5bcc 100644
--- 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>