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