[hackers] [dwm][PATCH] Edit man page: give keybindings headings

From: <truex_AT_equwal.com>
Date: Mon, 14 Sep 2020 01:53:49 -0700

From: Spenser Truex <truex_AT_equwal.com>

Previously the keybindings were core dumped into the manual, but now
they are grouped with the aim of making it easier to understand their
purposes on the first reading, and to reference back to them quickly.

---
 dwm.1 | 152 ++++++++++++++++++++++++++++++----------------------------
 1 file changed, 78 insertions(+), 74 deletions(-)
diff --git a/dwm.1 b/dwm.1
index ddc8321..e7aa556 100644
--- a/dwm.1
+++ b/dwm.1
_AT_@ -35,62 +35,23 @@ dwm draws a small border around windows to indicate the focus state.
 .B \-v
 prints version information to stderr, then exits.
 .SH USAGE
-.SS Status bar
-.TP
-.B X root window name
-is read and displayed in the status text area. It can be set with the
-.BR xsetroot (1)
-command.
-.TP
-.B Button1
-click on a tag label to display all windows with that tag, click on the layout
-label toggles between tiled and floating layout.
-.TP
-.B Button3
-click on a tag label adds/removes all windows with that tag to/from the view.
-.TP
-.B Mod1\-Button1
-click on a tag label applies that tag to the focused window.
-.TP
-.B Mod1\-Button3
-click on a tag label adds/removes that tag to/from the focused window.
-.SS Keyboard commands
-.TP
-.B Mod1\-Shift\-Return
-Start
-.BR st(1).
+.SS Program Commands
 .TP
 .B Mod1\-p
 Spawn
 .BR dmenu(1)
 for launching other programs.
 .TP
-.B Mod1\-,
-Focus previous screen, if any.
-.TP
-.B Mod1\-.
-Focus next screen, if any.
-.TP
-.B Mod1\-Shift\-,
-Send focused window to previous screen, if any.
-.TP
-.B Mod1\-Shift\-.
-Send focused window to next screen, if any.
-.TP
-.B Mod1\-b
-Toggles bar on and off.
-.TP
-.B Mod1\-t
-Sets tiled layout.
-.TP
-.B Mod1\-f
-Sets floating layout.
+.B Mod1\-Shift\-c
+Close focused window.
 .TP
-.B Mod1\-m
-Sets monocle layout.
+.B Mod1\-Shift\-Return
+Start
+.BR st(1).
 .TP
-.B Mod1\-space
-Toggles between current and previous layout.
+.B Mod1\-Shift\-q
+Quit dwm.
+.SS Window Commands
 .TP
 .B Mod1\-j
 Focus next window.
_AT_@ -98,11 +59,8 @@ Focus next window.
 .B Mod1\-k
 Focus previous window.
 .TP
-.B Mod1\-i
-Increase number of windows in master area.
-.TP
-.B Mod1\-d
-Decrease number of windows in master area.
+.B Mod1\-Return
+Zooms/cycles focused window to/from master area (tiled layouts only).
 .TP
 .B Mod1\-l
 Increase master area size.
_AT_@ -110,48 +68,94 @@ Increase master area size.
 .B Mod1\-h
 Decrease master area size.
 .TP
-.B Mod1\-Return
-Zooms/cycles focused window to/from master area (tiled layouts only).
+.B Mod1\-i
+Increase number of windows in master area.
 .TP
-.B Mod1\-Shift\-c
-Close focused window.
+.B Mod1\-d
+Decrease number of windows in master area.
 .TP
 .B Mod1\-Shift\-space
 Toggle focused window between tiled and floating state.
 .TP
-.B Mod1\-Tab
-Toggles to the previously selected tags.
+.B Mod1\-Button1
+Move focused window while dragging. Tiled windows will be toggled to the floating state.
+.TP
+.B Mod1\-Button2
+Toggles focused window between floating and tiled state.
+.TP
+.B Mod1\-Button3
+Resize focused window while dragging. Tiled windows will be toggled to the floating state.
+.SS Status Bar
+.TP
+.B X root window name
+is read and displayed in the status text area. It can be set with the
+.BR xsetroot (1)
+command.
+.TP
+.B Button1
+click on a tag label to display all windows with that tag, click on the layout
+label toggles between tiled and floating layout.
+.TP
+.B Button3
+click on a tag label adds/removes all windows with that tag to/from the view.
+.TP
+.B Mod1\-Button1
+click on a tag label applies that tag to the focused window.
+.TP
+.B Mod1\-Button3
+click on a tag label adds/removes that tag to/from the focused window.
+.TP
+.B Mod1\-b
+Toggles the status bar on and off.
+.SS Tags
+.TP
+.B Mod1\-0
+View all windows with any tag.
 .TP
 .B Mod1\-Shift\-[1..n]
 Apply nth tag to focused window.
 .TP
-.B Mod1\-Shift\-0
-Apply all tags to focused window.
+.B Mod1\-[1..n]
+View all windows with nth tag.
 .TP
 .B Mod1\-Control\-Shift\-[1..n]
 Add/remove nth tag to/from focused window.
 .TP
-.B Mod1\-[1..n]
-View all windows with nth tag.
+.B Mod1\-Tab
+Toggles to the previously selected tags.
 .TP
-.B Mod1\-0
-View all windows with any tag.
+.B Mod1\-Shift\-0
+Apply all tags to focused window.
 .TP
 .B Mod1\-Control\-[1..n]
 Add/remove all windows with nth tag to/from the view.
+.SS Layouts
 .TP
-.B Mod1\-Shift\-q
-Quit dwm.
-.SS Mouse commands
+.B Mod1\-t
+Sets tiled layout.
 .TP
-.B Mod1\-Button1
-Move focused window while dragging. Tiled windows will be toggled to the floating state.
+.B Mod1\-f
+Sets floating layout.
 .TP
-.B Mod1\-Button2
-Toggles focused window between floating and tiled state.
+.B Mod1\-m
+Sets monocle layout.
 .TP
-.B Mod1\-Button3
-Resize focused window while dragging. Tiled windows will be toggled to the floating state.
+.B Mod1\-space
+Toggles between current and previous layout.
+
+.SS Screens
+.TP
+.B Mod1\-.
+Focus next screen, if any.
+.TP
+.B Mod1\-,
+Focus previous screen, if any.
+.TP
+.B Mod1\-Shift\-,
+Send focused window to previous screen, if any.
+.TP
+.B Mod1\-Shift\-.
+Send focused window to next screen, if any.
 .SH CUSTOMIZATION
 dwm is customized by creating a custom config.h and (re)compiling the source
 code. This keeps it fast, secure and simple.
--
2.28.0

Received on Mon Sep 14 2020 - 10:53:49 CEST