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 a411978..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,47 +21,73 @@ 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
 prints version information to standard output, then exits.
 .SH USAGE
+.SS Status bar
 .TP
-.B Mod1-Return
-Zoom
-.B window
-to the 
-.B master
-column.
+.B Standard input
+is read and displayed in the status text area.
 .TP
-.B Mod1-h
-Focus previous
-.B tag.
+.B Button1
+click on a tag label views all windows with that
+.BR tag .
 .TP
-.B Mod1-j
+.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
-.B window.
+.BR window .
 .TP
-.B Mod1-k
+.B Mod1-Shift-Tab
 Focus previous
-.B window.
+.BR window .
 .TP
-.B Mod1-l
-Focus next
-.B tag.
+.B Mod1-Return
+Zoom current
+.B window
+to the 
+.B master
+column
+.RB ( tiling
+mode only).
 .TP
 .B Mod1-m
 Maximize current
-.B window.
+.BR window .
 .TP
-.B Mod1-[0..n]
-Focus
-.B nth tag.
+.B Mod1-Shift-[0..n]
+Apply
+.B nth tag
+to current
+.BR window .
+.TP
+.B Mod1-Control-Shift-[0..n]
+Add/remove
+.B nth tag
+to/from current
+.BR window .
+.TP
+.B Mod1-Shift-c
+Close focused
+.B window.
 .TP
 .B Mod1-space
 Toggle between
@@ -71,38 +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
-Moves current
+Move current
+.B window
+while dragging
+.RB ( floating
+mode only).
+.TP
+.B Mod1-Button2
+Zoom current
 .B window
-while dragging.
+to the 
+.B master
+column
+.RB ( tiling
+mode only).
 .TP
 .B Mod1-Button3
-Resizes current
+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)