JasonWoof Got questions, comments, patches, etc.? Contact Jason Woofenden
small changes to dwm.1, rearranged order within main event loop
[dwm.git] / dwm.1
diff --git a/dwm.1 b/dwm.1
index b79dba1..dcbdd89 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
@@ -21,11 +21,13 @@ tags. Selecting a certain tag 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 the text read from standard
+input. Besides that, it displays all available tags, and the title
+of the focused window.
+.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 tags
+and title.
 .SH OPTIONS
 .TP
 .B \-v
@@ -33,49 +35,60 @@ prints version information to standard output, then exits.
 .SH USAGE
 .SS Status bar
 .TP
-Writing to standard input displays the text in the status text area.
-.TP
-.B Button[1-3]
-click onto a tag label focusses the specifc tag.
+.B Standard input
+is read and displayed in the status text area.
 .TP
-.B Button[1,4]
-click focusses the previous tag.
+.B Button1
+click on a tag label views all windows with that
+.BR tag .
 .TP
-.B Button[2,5]
-click focusses the next tag.
+.B Button3
+click on a tag label adds/removes all windows with that
+.B tag
+to/from the view.
 .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.
-.TP
-.B Mod1-h
-Focus previous
-.B tag.
+column
+.RB ( tiling
+mode only).
 .TP
-.B Mod1-j
-Focus next
-.B window.
+.B Mod1-m
+Maximize current
+.BR window .
 .TP
-.B Mod1-k
-Focus previous
-.B window.
+.B Mod1-Shift-[0..n]
+Apply
+.B nth tag
+to current
+.BR window .
 .TP
-.B Mod1-l
-Focus next
-.B tag.
+.B Mod1-Control-Shift-[0..n]
+Add/remove
+.B nth tag
+to/from current
+.BR window .
 .TP
-.B Mod1-m
-Maximize current
+.B Mod1-Shift-c
+Close focused
 .B window.
 .TP
-.B Mod1-[0..n]
-Focus
-.B nth tag.
-.TP
 .B Mod1-space
 Toggle between
 .B tiled
@@ -84,46 +97,54 @@ and
 mode (affects
 .BR "all windows" ).
 .TP
-.B Mod1-Shift-[0..n]
-Apply
-.B nth tag
-to current
-.B window.
+.B Mod1-[0..n]
+View all windows with
+.BR "tag n" .
+.TP
+.B Mod1-Control-[0..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.
 .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 displays
+.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)