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 Button2
 51click on a tag label adds/removes that
 52.B tag
 53to/from the focused
 54.B window.
 55.TP
 56.B Button3
 57click on a tag label adds/removes all windows with that
 58.B tag
 59to/from the view.
 60.SS Keyboard commands
 61.TP
 62.B Mod1-Shift-Return
 63Start
 64.BR xterm (1).
 65.TP
 66.B Mod1-Tab
 67Focus next
 68.BR window .
 69.TP
 70.B Mod1-Shift-Tab
 71Focus previous
 72.BR window .
 73.TP
 74.B Mod1-Return
 75Zoom current
 76.B window
 77to the 
 78.B master
 79column
 80.RB ( tiling
 81mode only).
 82.TP
 83.B Mod1-m
 84Maximize current
 85.BR window .
 86.TP
 87.B Mod1-Shift-[0..n]
 88Apply
 89.B nth tag
 90to current
 91.BR window .
 92.TP
 93.B Mod1-Control-Shift-[0..n]
 94Add/remove
 95.B nth tag
 96to/from current
 97.BR window .
 98.TP
 99.B Mod1-Shift-c
100Close focused
101.B window.
102.TP
103.B Mod1-space
104Toggle between
105.B tiled
106and
107.B floating
108mode (affects
109.BR "all windows" ).
110.TP
111.B Mod1-[0..n]
112View all windows with
113.BR "tag n" .
114.TP
115.B Mod1-Control-[0..n]
116Add/remove all windows with
117.B tag n
118to/from the view.
119.TP
120.B Mod1-Shift-q
121Quit
122.B dwm.
123.SS Mouse commands
124.TP
125.B Mod1-Button1
126Move current
127.B window
128while dragging
129.RB ( floating
130mode only).
131.TP
132.B Mod1-Button2
133Zoom current
134.B window
135to the 
136.B master
137column
138.RB ( tiling
139mode only).
140.TP
141.B Mod1-Button3
142Resize current
143.B window
144while dragging
145.RB ( floating
146mode only).
147.SH CUSTOMIZATION
148.B dwm
149is customized by creating a custom config.h and (re)compiling the source
150code. This keeps it fast, secure and simple.
151.SH CAVEATS
152The status bar may display
153.B broken pipe
154when
155.B dwm
156has been started by
157.BR xdm (1),
158because it closes standard output before executing
159.BR dwm .
160.SH SEE ALSO
161.BR dmenu (1)