.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
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 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
.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 toggles that
-.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-Shift-[1..n]
+Apply
+.B nth tag
+to current
+.BR window .
.TP
-.B Mod1-l
-Focus next
-.B tag.
+.B Mod1-Control-Shift-[1..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
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]
-Toggle
-.B nth tag.
-.TP
-.B Mod1-Control-Shift-[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
-.BR "broken pipe"
+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
-.B dwm.
+.BR dwm .
.SH SEE ALSO
.BR dmenu (1)
Got questions, comments, patches, etc.? Contact Jason Woofenden