1.TH DWM 1 dwm-VERSION
  2.SH NAME
  3dwm \- dynamic window manager
  4.SH SYNOPSIS
  5.B dwm
  6.RB [ \-v ]
  7.SH DESCRIPTION
  8.B dwm
  9is a dynamic window manager for X. It manages windows in tiling and floating
 10modes. Either mode can be applied dynamically, optimizing the environment for
 11the application in use and the task performed.
 12.P
 13In tiling mode windows are managed in a master and stacking column. The master
 14column contains the window which currently needs most attention, whereas the
 15stacking column contains all other windows. In floating mode windows can be
 16resized and moved freely. Dialog windows are always managed floating,
 17regardless of the mode selected.
 18.P
 19Windows are grouped by tags. Each window can be tagged with one or multiple
 20tags. Selecting a certain tag for viewing will display all windows with that
 21tag.
 22.P
 23.B dwm
 24contains a small status bar which displays all available tags, the mode, the
 25title of the focused window, and the text read from standard input. The tags of
 26the focused window are highlighted with a small point.
 27.P
 28.B dwm
 29draws a 1-pixel border around windows to indicate the focus state.
 30Unfocused windows contain a small bar in front of them displaying their title.
 31.SH OPTIONS
 32.TP
 33.B \-v
 34prints version information to standard output, then exits.
 35.SH USAGE
 36.SS Status bar
 37.TP
 38.B Standard input
 39is read and displayed in the status text area.
 40.TP
 41.B Button1
 42click on a tag label views all windows with that
 43.BR tag ,
 44click on the mode label toggles between
 45.B tiled
 46and
 47.B floating
 48mode.
 49.TP
 50.B Button3
 51click on a tag label adds/removes all windows with that
 52.B tag
 53to/from the view.
 54.SS Keyboard commands
 55.TP
 56.B Mod1-Shift-Return
 57Start
 58.BR xterm (1).
 59.TP
 60.B Mod1-Tab
 61Focus next
 62.BR window .
 63.TP
 64.B Mod1-Shift-Tab
 65Focus previous
 66.BR window .
 67.TP
 68.B Mod1-Return
 69Zoom current
 70.B window
 71to the 
 72.B master
 73column
 74.RB ( tiling
 75mode only).
 76.TP
 77.B Mod1-m
 78Maximize current
 79.BR window .
 80.TP
 81.B Mod1-Shift-[0..n]
 82Apply
 83.B nth tag
 84to current
 85.BR window .
 86.TP
 87.B Mod1-Control-Shift-[0..n]
 88Add/remove
 89.B nth tag
 90to/from current
 91.BR window .
 92.TP
 93.B Mod1-Shift-c
 94Close focused
 95.B window.
 96.TP
 97.B Mod1-space
 98Toggle between
 99.B tiled
100and
101.B floating
102mode (affects
103.BR "all windows" ).
104.TP
105.B Mod1-[0..n]
106View all windows with
107.BR "tag n" .
108.TP
109.B Mod1-Control-[0..n]
110Add/remove all windows with
111.B tag n
112to/from the view.
113.TP
114.B Mod1-Shift-q
115Quit
116.B dwm.
117.SS Mouse commands
118.TP
119.B Mod1-Button1
120Move current
121.B window
122while dragging
123.RB ( floating
124mode only).
125.TP
126.B Mod1-Button2
127Zoom current
128.B window
129to the 
130.B master
131column
132.RB ( tiling
133mode only).
134.TP
135.B Mod1-Button3
136Resize current
137.B window
138while dragging
139.RB ( floating
140mode only).
141.SH CUSTOMIZATION
142.B dwm
143is customized by creating a custom config.h and (re)compiling the source
144code. This keeps it fast, secure and simple.
145.SH CAVEATS
146The status bar may display
147.B broken pipe
148when
149.B dwm
150has been started by
151.BR xdm (1),
152because it closes standard output before executing
153.BR dwm .
154.SH SEE ALSO
155.BR dmenu (1)