small addition to dwm.1

[dwm.git] / dwm.1

diff --git a/dwm.1 b/dwm.1
index 47fceeb..b0d236c 100644 (file)
--- a/dwm.1
+++ b/dwm.1
@@ -6,7 +6,7 @@ dwm \- dynamic window manager
 .RB [ \-v ]
 .SH DESCRIPTION
 .B dwm
-is a dynamic window manager for X11. It manages windows in tiling and floating
+is a dynamic window manager for X. It manages windows in tiling and floating
 modes. Either mode can be applied dynamically, optimizing the environment for
 the application in use and the task performed.
 .P
@@ -17,15 +17,17 @@ resized and moved freely. Dialog windows are always managed floating,
 regardless of the mode selected.
 .P
 Windows are grouped by tags. Each window can be tagged with one or multiple
-tags. Selecting a certain tag for viewing will display all windows with that
-tag.
+tags. Selecting certain tags for viewing will display all windows with that tag.
 .P
 .B dwm
-has a small status bar which displays the text read from standard
-input, if written. Besides that, it displays all available tags, and the title
-of the focused window. It draws a 1-pixel border around windows to
-indicate the focus state. Unfocused windows contain a small bar in front of
-them displaying their tags and title.
+contains a small status bar which displays all available tags, the mode, the
+title of the focused window, and the text read from standard input. The
+selected tags are highlighted with a different color, the tags of the focused
+window are highlighted with a small point.
+.P
+.B dwm
+draws a 1-pixel border around windows to indicate the focus state.
+Unfocused windows contain a small bar in front of them displaying their title.
 .SH OPTIONS
 .TP
 .B \-v
@@ -36,53 +38,85 @@ prints version information to standard output, then exits.
 .B Standard input
 is read and displayed in the status text area.
 .TP
-.B Button[1,3]
-click on a tag label focuses that
-.B tag.
+.B Button1
+click on a tag label views all windows with that
+.BR tag ,
+click on the mode label toggles between
+.B tiled
+and
+.B floating
+mode.
 .TP
-.B Button2
-click on a tag label (un)extends the current
-.B tag.
+.B Button3
+click on a tag label adds/removes all windows with that
+.B tag
+to/from the view.
 .TP
-.B Button[1,4]
-click on the bar focuses the previous
-.B tag.
+.B Mod1-Button1
+click on a tag label applies that
+.B tag
+to the focused
+.BR window .
 .TP
-.B Button[2,5]
-click on the bar focuses the next
-.B tag.
+.B Mod1-Button3
+click on a tag label adds/removes that
+.B tag
+to/from the focused
+.BR window .
 .SS Keyboard commands
 .TP
+.B Mod1-Shift-Return
+Start
+.BR xterm (1).
+.TP
+.B Mod1-Tab
+Focus next
+.BR window .
+.TP
+.B Mod1-Shift-Tab
+Focus previous
+.BR window .
+.TP
 .B Mod1-Return
 Zoom current
 .B window
 to the 
 .B master
-column.
+column
+.RB ( tiling
+mode only).
 .TP
-.B Mod1-h
-Focus previous
-.B tag.
+.B Mod1-m
+Maximize current
+.BR window .
 .TP
-.B Mod1-j
-Focus next
-.B window.
+.B Mod1-g
+Grow current
+.BR column
+.RB ( tiling
+mode only).
 .TP
-.B Mod1-k
-Focus previous
-.B window.
+.B Mod1-s
+Shrink current
+.BR column
+.RB ( tiling
+mode only).
 .TP
-.B Mod1-l
-Focus next
-.B tag.
+.B Mod1-Shift-[1..n]
+Apply
+.B nth tag
+to current
+.BR window .
 .TP
-.B Mod1-m
-Maximize current
-.B window.
+.B Mod1-Control-Shift-[1..n]
+Add/remove
+.B nth tag
+to/from current
+.BR window .
 .TP
-.B Mod1-[0..n]
-Focus
-.B nth tag.
+.B Mod1-Shift-c
+Close focused
+.B window.
 .TP
 .B Mod1-space
 Toggle between
@@ -92,56 +126,58 @@ and
 mode (affects
 .BR "all windows" ).
 .TP
-.B Mod1-Shift-[0..n]
-Apply
-.B nth tag
-to current
-.B window.
+.B Mod1-[1..n]
+View all windows with
+.BR "tag n" .
 .TP
-.B Mod1-Shift-c
-Close focused
-.B window.
+.B Mod1-0
+View all windows with any
+.BR "tag" .
+.TP
+.B Mod1-Control-[1..n]
+Add/remove all windows with
+.B tag n
+to/from the view.
 .TP
 .B Mod1-Shift-q
 Quit
 .B dwm.
-.TP
-.B Mod1-Shift-Return
-Start
-.B terminal.
-.TP
-.B Mod1-Control-[0..n]
-Append
-.B nth tag
-to current
-.B window.
-.TP
-.B Mod1-Control-Shift-[0..n]
-(Un)extends
-.B nth tag
-with current
-.B tag.
 .SS Mouse commands
 .TP
 .B Mod1-Button1
 Move current
 .B window
-while dragging.
+while dragging
+.RB ( floating
+mode only).
 .TP
 .B Mod1-Button2
 Zoom current
 .B window
 to the 
 .B master
-column.
+column
+.RB ( tiling
+mode only).
 .TP
 .B Mod1-Button3
 Resize current
 .B window
-while dragging.
+while dragging
+.RB ( floating
+mode only).
 .SH CUSTOMIZATION
 .B dwm
 is customized by creating a custom config.h and (re)compiling the source
 code. This keeps it fast, secure and simple.
+.SH CAVEATS
+The status bar may display
+.B broken pipe
+when
+.B dwm
+has been started by
+.BR xdm (1),
+because it closes standard output before executing
+.BR dwm .
 .SH SEE ALSO
 .BR dmenu (1)