Cleaned up and updated man page for DWM

This will provide up to date references to my key bindings!

1 files changed, 172 insertions, 89 deletions

diff --git a/dwm.1 b/dwm.1
index ddc8321..5c68e2e 100644
--- a/dwm.1
+++ b/dwm.1
@@ -5,29 +5,59 @@ dwm \- dynamic window manager
 .B dwm
 .RB [ \-v ]
 .SH DESCRIPTION
-dwm is a dynamic window manager for X. It manages windows in tiled, monocle
-and floating layouts. Either layout can be applied dynamically, optimising the
-environment for the application in use and the task performed.
+dwm is a dynamic window manager for X.  It manages windows in a
+variety of layouts:
+.nr PI 1n
+.IP \[bu]
+floating: windows can be resized and moved freely, a la usual window
+managers.
+.IP \[bu]
+tiled: windows are managed in a master and stacking area.  The master
+area on the left contains one window by default, and the stacking area
+on the right contains all other windows.  The number of master area
+windows can be adjusted from zero to an arbitrary number.
+.IP \[bu]
+monocle (normal, centred or floating)
+
+Normal: all windows are maximised to the screen size.
+
+Centred: the screen is split into three sections with the master
+clients getting the second section and the stacking clients get the
+remaining 2 sections to be laid out in.
+
+Floating: the master clients are placed floating in the centre of the
+screen while the remaining stacking clients are placed side by side
+vertically.
+.IP \[bu]
+fibonacci (dwindle and spiral): windows are tiled in a spiralling or
+dwindling pattern.
+
+In the dwindle layout new clients tend towards the bottom left of the
+monitor while in the spiral layout clients tend towards the centre
+bottom left.
+.IP \[bu]
+deck: the stacking clients are placed floating on top of each other
+such that there are only two partitions of the screen space.
+.IP \[bu]
+gapless grid: n clients are arranged into a square of ceil(sqrt(n))
+length, where the top left is the latest client opened.
 .P
-In tiled layouts windows are managed in a master and stacking area. The master
-area on the left contains one window by default, and the stacking area on the
-right contains all other windows. The number of master area windows can be
-adjusted from zero to an arbitrary number. In monocle layout all windows are
-maximised to the screen size. In floating layout windows can be resized and
-moved freely. Dialog windows are always managed floating, regardless of the
-layout applied.
+Dialog windows are always managed floating, regardless of the layout
+applied.
 .P
-Windows are grouped by tags. Each window can be tagged with one or multiple
-tags. Selecting certain tags displays all windows with these tags.
+Windows are grouped by tags. Each window can be tagged with one or
+multiple tags. Selecting certain tags displays all windows with these
+tags.
 .P
-Each screen contains a small status bar which displays all available tags, the
-layout, the title of the focused window, and the text read from the root window
-name property, if the screen is focused. A floating window is indicated with an
-empty square and a maximised floating window is indicated with a filled square
-before the windows title.  The selected tags are indicated with a different
-color. The tags of the focused window are indicated with a filled square in the
-top left corner.  The tags which are applied to one or more windows are
-indicated with an empty square in the top left corner.
+Each screen contains a small status bar which displays all available
+tags, the layout, the title of the focused window, and the text read
+from the root window name property, if the screen is focused. A
+floating window is indicated with an empty square and a maximised
+floating window is indicated with a filled square before the windows
+title.  The selected tags are indicated with a different color. The
+tags of the focused window are indicated with a filled square in the
+top left corner.  The tags which are applied to one or more windows
+are indicated with an empty square in the top left corner.
 .P
 dwm draws a small border around windows to indicate the focus state.
 .SH OPTIONS
@@ -39,119 +69,172 @@ prints version information to stderr, then exits.
 .TP
 .B X root window name
 is read and displayed in the status text area. It can be set with the
-.BR xsetroot (1)
+.BR xsetroot (1).  This fork uses dwmblocks to generate system status information.
 command.
+.SS Keyboard commands
+Mod is set to Super (the "windows" key).
 .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.
+.B Mod\-b
+Toggle status bar
+
 .TP
-.B Button3
-click on a tag label adds/removes all windows with that tag to/from the view.
+.B Mod\-`
+Toggle scratchpad terminal (set to
+.BR st(1)
+)
+
+.TP
+.B Mod\-j
+Focus next window
+
+.TP
+.B Mod\-k
+Focus previous window
+
 .TP
-.B Mod1\-Button1
-click on a tag label applies that tag to the focused window.
+.B Mod\-.
+Increase gap size
+
 .TP
-.B Mod1\-Button3
-click on a tag label adds/removes that tag to/from the focused window.
-.SS Keyboard commands
+.B Mod\-,
+Decrease gap size
+
 .TP
-.B Mod1\-Shift\-Return
-Start
-.BR st(1).
+.B Mod\-/
+Toggle gaps
+
 .TP
-.B Mod1\-p
-Spawn
-.BR dmenu(1)
-for launching other programs.
+.B Mod\-Shift\-/
+Print current gap value (using
+.BR notify-send(1)
+)
+
 .TP
-.B Mod1\-,
-Focus previous screen, if any.
+.B Mod\-h
+Decrease size of master area
+
 .TP
-.B Mod1\-.
-Focus next screen, if any.
+.B Mod\-l
+Increase size of master are
+
 .TP
-.B Mod1\-Shift\-,
-Send focused window to previous screen, if any.
+.B Mod\-Control\-.
+Decrease number of master clients
+
 .TP
-.B Mod1\-Shift\-.
-Send focused window to next screen, if any.
+.B Mod\-Control\-,
+Increase number of master clients
+
 .TP
-.B Mod1\-b
-Toggles bar on and off.
+.B Mod\-Shift\-h
+Rotate the stack clockwise but keep focus on the same position.
+
 .TP
-.B Mod1\-t
-Sets tiled layout.
+.B Mod\-Shift\-l
+Rotate the stack anticlockwise but keep focus on the same position.
+
 .TP
-.B Mod1\-f
-Sets floating layout.
+.B Mod\-Shift\-k
+Rotate the master clients clockwise but keep focus on the same position.
+
 .TP
-.B Mod1\-m
-Sets monocle layout.
+.B Mod\-Shift\-j
+Rotate the master clients anticlockwise but keep focus on the same position.
+
 .TP
-.B Mod1\-space
-Toggles between current and previous layout.
+.B Mod\-c
+If in stack area, swap currently focused client with master.  If in master area, swap currently focused client with top of stack area.
+
 .TP
-.B Mod1\-j
-Focus next window.
+.B Mod\-Shift\-t
+Set layout to tiling
+
 .TP
-.B Mod1\-k
-Focus previous window.
+.B Mod\-Shift\-f
+Set layout to floating
+
 .TP
-.B Mod1\-i
-Increase number of windows in master area.
+.B Mod\-Shift\-m
+Set layout to monocle
+
 .TP
-.B Mod1\-d
-Decrease number of windows in master area.
+.B Mod\-Shift\-u
+Set layout to centred monocle
+
 .TP
-.B Mod1\-l
-Increase master area size.
+.B Mod\-Shift\-o
+Set layout to centred floating monocle
+
 .TP
-.B Mod1\-h
-Decrease master area size.
+.B Mod\-Shift\-s
+Set layout to spiral fibonacci
+
 .TP
-.B Mod1\-Return
-Zooms/cycles focused window to/from master area (tiled layouts only).
+.B Mod\-Shift\-d
+Set layout to dwindle fibonacci
+
 .TP
-.B Mod1\-Shift\-c
-Close focused window.
+.B Mod\-Shift\-g
+Set layout to gapless grid
+
 .TP
-.B Mod1\-Shift\-space
-Toggle focused window between tiled and floating state.
+.B Mod\-Shift\-i
+Set layout to deck
+
 .TP
-.B Mod1\-Tab
-Toggles to the previously selected tags.
+.B Mod\-Shift\-space
+Toggle between current layout and previous layout
+
+.TP
+.B Mod\-space
+Toggle current client's floating (floating -> not floating, not floating -> floating)
+
+.TP
+.B Mod1\-[1..n]
+Go to nth tag
+
 .TP
 .B Mod1\-Shift\-[1..n]
-Apply nth tag to focused window.
+Send focused client to nth tag.
+
 .TP
-.B Mod1\-Shift\-0
-Apply all tags to focused window.
+.B Mod\-m
+Focus on the next monitor in monitor stack
+
 .TP
-.B Mod1\-Control\-Shift\-[1..n]
-Add/remove nth tag to/from focused window.
+.B Mod\-Shift\-,
+Send client to previous monitor in monitor stack
+
 .TP
-.B Mod1\-[1..n]
-View all windows with nth tag.
+.B Mod\-Shift\-.
+Send client to next monitor in monitor stack
+
 .TP
-.B Mod1\-0
-View all windows with any tag.
+.B Mod\-Tab
+View the previous tag
+
 .TP
-.B Mod1\-Control\-[1..n]
-Add/remove all windows with nth tag to/from the view.
+.B Mod\-q
+Kill the currently focused client
+
 .TP
-.B Mod1\-Shift\-q
-Quit dwm.
+.B Mod\-Shift\-q
+Kill dwm
+
 .SS Mouse commands
+
 .TP
 .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.
+
 .SH CUSTOMIZATION
 dwm is customized by creating a custom config.h and (re)compiling the source
 code. This keeps it fast, secure and simple.