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-[1..n]
 88Apply
 89.B nth tag
 90to current
 91.BR window .
 92.TP
 93.B Mod1-Control-Shift-[1..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-[1..n]
112View all windows with
113.BR "tag n" .
114.TP
115.B Mod1-0
116View all windows with any
117.BR "tag" .
118.TP
119.B Mod1-Control-[1..n]
120Add/remove all windows with
121.B tag n
122to/from the view.
123.TP
124.B Mod1-Shift-q
125Quit
126.B dwm.
127.SS Mouse commands
128.TP
129.B Mod1-Button1
130Move current
131.B window
132while dragging
133.RB ( floating
134mode only).
135.TP
136.B Mod1-Button2
137Zoom current
138.B window
139to the 
140.B master
141column
142.RB ( tiling
143mode only).
144.TP
145.B Mod1-Button3
146Resize current
147.B window
148while dragging
149.RB ( floating
150mode only).
151.SH CUSTOMIZATION
152.B dwm
153is customized by creating a custom config.h and (re)compiling the source
154code. This keeps it fast, secure and simple.
155.SH CAVEATS
156The status bar may display
157.B broken pipe
158when
159.B dwm
160has been started by
161.BR xdm (1),
162because it closes standard output before executing
163.BR dwm .
164.SH SEE ALSO
165.BR dmenu (1)