a start to cleaning:

- no reason for pointer movement and window movement and resizing
  sections that just describe default key bindings
- key bindings are for all search and exec dialogs, not just for windows
- adding missing bindings
- normalize and wordsmith
- re-order sections according to mdoc(7)

feedback and ok from jmc@

cwm.1

@@ -28,19 +28,40 @@
 .Sh DESCRIPTION
 .Nm
 is a window manager for X11 which contains many features that
-concentrate on the efficiency and transparency of window management.
+concentrate on the efficiency and transparency of window management,
-.Nm
+while maintaining the simplest and most pleasant aesthetic.
-also aims to maintain the simplest and most pleasant aesthetic.
 .Pp
-The following notation is used throughout this page:
+The options are as follows:
+.Bl -tag -width Ds
+.It Fl c Ar file
+Specify an alternative configuration file.
+By default,
+.Nm
+loads
+.Pa ~/.cwmrc ,
+if present.
+Any error messages from lines in the configuration file will be sent to
+.Em stderr ;
+however,
+.Nm
+will continue to process the rest of the configuration file.
+.It Fl d Ar display
+Specify the display to use.
+.El
+.Pp
+.Nm
+actions are initiated either via key or mouse bindings.
+The following notations are used throughout this page:
 .Pp
 .Bl -tag -width Ds -offset indent -compact
 .It Ic C
-Control.
+Control key.
 .It Ic M
-Meta.
+Meta key.
 .It Ic S
-Shift.
+Shift key.
+.It Ic 4
+Mod4 (windows) key.
 .It Ic M1
 Left mouse button.
 .It Ic M2
@@ -49,11 +70,7 @@ Middle mouse button.
 Right mouse button.
 .El
 .Pp
-.Nm
+The default key bindings are:
-is very simple in its use.
-Most of the actions are initiated via key bindings.
-The default key bindings are described below;
-their functionality is described in more detail later.
 .Pp
 .Bl -tag -width "CM-EscapeXXXXX" -offset indent -compact
 .It Ic CM-Return
@@ -100,6 +117,21 @@ Toggle maximization of current window.
 Toggle vertical maximization of current window.
 .It Ic CMS-=
 Toggle horizontal maximization of current window.
+.It Ic C-[Up|Down|Left|Right]
+Move pointer by a small amount.
+.It Ic CS-[Up|Down|Left|Right]
+Move pointer by a large amount; see
+.Xr cwmrc 5 .
+.It Ic M-[hjkl]
+Move window by a small amount.
+.It Ic MS-[hjkl]
+Move window by a large amount; see
+.Xr cwmrc 5 .
+.It Ic CM-[hjkl]
+Resize window by a small amount.
+.It Ic CMS-[hjkl]
+Resize window by a large amount; see
+.Xr cwmrc 5 .
 .It Ic M-?
 Spawn
 .Dq exec program
@@ -116,20 +148,16 @@ will be executed via the configured terminal emulator.
 .It Ic CM-w
 Spawn
 .Dq exec WindowManager
-dialog; allows you to switch from
+dialog, allowing a switch to another window manager.
-.Nm
-to another window manager without restarting the X server.
 .It Ic CMS-r
-Restart the running
+Restart.
-.Xr cwm 1 .
 .It Ic CMS-q
-Quit
+Quit.
-.Nm .
 .El
 .Pp
 The default mouse bindings are:
 .Pp
-.Bl -tag -width Ds -offset indent -compact
+.Bl -tag -width "CM-EscapeXXXXX" -offset indent -compact
 .It Ic M-M1
 Move current window.
 .It Ic CM-M1
@@ -142,56 +170,25 @@ Lower current window.
 Hide current window.
 .El
 .Pp
-The options for
+The following key bindings may be used to navigate
-.Nm
+search and exec dialogs:
-are as follows:
-.Bl -tag -width Ds
-.It Fl c Ar file
-Specify an alternative configuration file.
-By default,
-.Nm
-loads
-.Pa ~/.cwmrc ,
-if present.
-Any error messages from lines in the configuration file will be sent to
-.Em stderr ;
-however,
-.Nm
-will continue to process the rest of the configuration file.
-.It Fl d Ar display
-Specify the display to use.
-.El
-.Sh POINTER MOVEMENT
-The pointer can be moved with the use of the keyboard through bindings.
-.Ic C-[Up|Down|Left|Right]
-moves the pointer a small amount, while
-.Ic CS-[Up|Down|Left|Right]
-moves the pointer a larger amount.
-For example, to move the pointer to the left by a small amount,
-press
-.Ic C-Left .
-To move the pointer down by a larger amount, press
-.Ic CS-Down .
-.Sh WINDOW MOVEMENT AND RESIZING
-.Nm
-windows can be moved with the use of the keyboard through
-.Cm vi Ns -like
-bindings.
-.Ic M-[hjkl]
-moves the current window a small amount, while
-.Ic MS-[hjkl]
-moves the current window a larger amount.
-For example, to move the current window to the left a small amount, press
-.Ic M-h .
-To move the current window down by a larger amount, press
-.Ic MS-j .
 .Pp
-Similarly, windows may be resized with the same key bindings with the addition
+.Bl -tag -width "[Down] or C-s or M-j" -offset indent -compact
-of the Control key.
+.It Ic [Return]
-.Ic CM-[hjkl]
+Select item.
-resizes the window a small amount and
+.It Ic [Down], C-s No or Ic M-j
-.Ic CMS-[hjkl]
+Next item.
-resizes by a larger increment.
+.It Ic [Up], C-r No or Ic M-k
+Previous item.
+.It Ic [Backspace] No or Ic C-h
+Backspace.
+.It Ic C-u
+Clear input.
+.It Ic C-a
+List all available items.
+.It Ic [Esc]
+Cancel.
+.El
 .Sh SEARCH
 .Nm
 features the ability to search for windows by their current title,
@@ -204,37 +201,16 @@ keeps a history of the 5 previous titles of a window.
 When searching, the leftmost character of the result list may show a
 flag:
 .Pp
-.Bl -tag -width 10n -offset indent -compact
+.Bl -tag -width Ds -offset indent -compact
 .It !
-The window is the currently focused window.
+Window is currently focused.
 .It &
-The window is hidden.
+Window is hidden.
-.El
-.Pp
-The following key bindings may be used to navigate the result list:
-.Pp
-.Bl -tag -width "[Down] or C-s or M-j" -offset indent -compact
-.It Ic [Down], C-s No or Ic M-j
-Select the next window in the list.
-.It Ic [Up], C-r No or Ic M-k
-Select the previous window in the list.
-.It Ic [Backspace] No or Ic C-h
-Backspace.
-.It Ic C-u
-Clear the input.
-.It Ic [Return]
-Focus the selected window.
-.It Ic [Esc]
-Cancel.
-.It Ic C-a
-Whenever there are no matching windows, list every window.
 .El
 .Sh GROUPS
 .Nm
 has the ability to group windows together, and use the groups to
 perform operations on the entire group instead of just one window.
-Currently, the only operation that is supported is to hide and unhide
-the grouped windows.
 Together with the
 .Pa sticky
 option, this can be used to emulate virtual desktops.
@@ -246,20 +222,20 @@ and a red border will be shown on those just removed.
 .Sh MENUS
 Menus are recalled by clicking the mouse on the root window:
 .Pp
-.Bl -tag -width 10n -offset indent -compact
+.Bl -tag -width Ds -offset indent -compact
 .It Ic M1
 Show list of currently hidden windows.
-Clicking on an item will unhide that window.
+Selecting an item will unhide that window.
 .It Ic M2
 Show list of currently defined groups.
-Clicking on an item will hide/unhide that group.
+Selecting an item will hide/unhide that group.
 .It Ic M3
 Show list of applications as defined in
 .Pa ~/.cwmrc .
-Clicking on an item will spawn that application.
+Selecting an item will spawn that application.
 .El
 .Sh ENVIRONMENT
-.Bl -tag -width "DISPLAYXXX"
+.Bl -tag -width "DISPLAYXXX" -compact
 .It DISPLAY
 .Nm
 starts on this display unless the
@@ -267,8 +243,11 @@ starts on this display unless the
 option is given.
 .El
 .Sh FILES
-.Bl -tag -width Ds
+.Bl -tag -width "~/.cwmrcXX" -compact
 .It Pa ~/.cwmrc
+Default
+.Nm
+configuration file.
 .El
 .Sh SEE ALSO
 .Xr cwmrc 5

cwmrc.5

@@ -72,14 +72,14 @@ The modifier keys come first, followed by a
 The following modifiers are recognised:
 .Pp
 .Bl -tag -width Ds -offset indent -compact
-.It C
+.It Ic C
-The Control key.
+Control key.
-.It M
+.It Ic M
-The Meta key.
+Meta key.
-.It S
+.It Ic S
-The Shift key.
+Shift key.
-.It 4
+.It Ic 4
-The Mod4 key (normally the windows key).
+Mod4 (windows) key.
 .El
 .Pp
 The
@@ -186,14 +186,14 @@ The modifier keys come first, followed by a
 The following modifiers are recognised:
 .Pp
 .Bl -tag -width Ds -offset indent -compact
-.It C
+.It Ic C
-The Control key.
+Control key.
-.It M
+.It Ic M
-The Meta key.
+Meta key.
-.It S
+.It Ic S
-The Shift key.
+Shift key.
-.It 4
+.It Ic 4
-The Mod4 key (normally the windows key).
+Mod4 (windows) key.
 .El
 .Pp
 The
@@ -201,15 +201,15 @@ The
 should be followed by number:
 .Pp
 .Bl -tag -width Ds -offset indent -compact
-.It 1
+.It Ic 1
 Left mouse button.
-.It 2
+.It Ic 2
 Middle mouse button.
-.It 3
+.It Ic 3
 Right mouse button.
-.It 4
+.It Ic 4
 Scroll up mouse button.
-.It 5
+.It Ic 5
 Scroll down mouse button.
 .El
 .Pp
@@ -235,48 +235,6 @@ By enabling sticky group mode,
 .Xr cwm 1
 will assign new windows to the currently selected group.
 .El
-.Sh EXAMPLE CONFIGURATION
-.Bd -literal
-# Set default Xft(3) font
-fontname "sans-serif:pixelsize=14:bold"
-
-# Turn on sticky-group mode
-sticky yes
-
-# Any entry here is shown in the application menu
-command firefox		firefox
-command xmms		xmms
-command top		"xterm -e top"
-
-# Autogroup definitions
-autogroup 3 "aterm,XTerm"
-autogroup 3 "xterm,XTerm"
-
-# Ignore programs by that name by not drawing borders around them.
-ignore XMMS
-ignore xwi
-ignore xapm
-ignore xclock
-
-# Key bindings
-bind CM-r	label
-bind CS-Return	"xterm -e top"
-bind 4-o	unmap
-bind CM-equal	unmap
-bind CMS-equal	unmap
-bind C4-equal	vmaximize
-bind C4S-equal	hmaximize
-bind M-1	grouponly1
-bind M-2	grouponly2
-bind M-3	grouponly3
-bind MS-1	movetogroup1
-bind MS-2	movetogroup2
-bind MS-3	movetogroup3
-
-# Mouse bindings
-mousebind M-2	window_lower
-mousebind M-3	window_resize
-.Ed
 .Sh BIND COMMAND LIST
 .Bl -tag -width 18n -compact
 .It restart
@@ -482,10 +440,52 @@ Launch command list.
 .Sh FILES
 .Bl -tag -width "~/.cwmrcXXX" -compact
 .It Pa ~/.cwmrc
-default
+Default
 .Xr cwm 1
-configuration file
+configuration file.
 .El
+.Sh EXAMPLES
+.Bd -literal
+# Set default Xft(3) font
+fontname "sans-serif:pixelsize=14:bold"
+
+# Turn on sticky-group mode
+sticky yes
+
+# Any entry here is shown in the application menu
+command firefox		firefox
+command xmms		xmms
+command top		"xterm -e top"
+
+# Autogroup definitions
+autogroup 3 "aterm,XTerm"
+autogroup 3 "xterm,XTerm"
+
+# Ignore programs by that name by not drawing borders around them.
+ignore XMMS
+ignore xwi
+ignore xapm
+ignore xclock
+
+# Key bindings
+bind CM-r	label
+bind CS-Return	"xterm -e top"
+bind 4-o	unmap
+bind CM-equal	unmap
+bind CMS-equal	unmap
+bind C4-equal	vmaximize
+bind C4S-equal	hmaximize
+bind M-1	grouponly1
+bind M-2	grouponly2
+bind M-3	grouponly3
+bind MS-1	movetogroup1
+bind MS-2	movetogroup2
+bind MS-3	movetogroup3
+
+# Mouse bindings
+mousebind M-2	window_lower
+mousebind M-3	window_resize
+.Ed
 .Sh SEE ALSO
 .Xr cwm 1
 .Sh HISTORY