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 X11. 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
 24has a small status bar which displays the text read from standard
 25input, if written. Besides that, it displays all available tags, and the title
 26of the focused window. It draws a 1-pixel border around windows to
 27indicate the focus state. Unfocused windows contain a small bar in front of
 28them displaying their tags and title.
 29.SH OPTIONS
 30.TP
 31.B \-v
 32prints version information to standard output, then exits.
 33.SH USAGE
 34.SS Status bar
 35.TP
 36.B Standard input
 37is read and displayed in the status text area.
 38.TP
 39.B Button1
 40click on a tag label views all windows with that
 41.BR tag .
 42.TP
 43.B Button3
 44click on a tag label adds/removes all windows with that
 45.B tag
 46to/from the view.
 47.SS Keyboard commands
 48.TP
 49.B Mod1-Shift-Return
 50Start
 51.BR xterm (1).
 52.TP
 53.B Mod1-Tab
 54Focus next
 55.BR window .
 56.TP
 57.B Mod1-Shift-Tab
 58Focus previous
 59.BR window .
 60.TP
 61.B Mod1-Return
 62Zoom current
 63.B window
 64to the 
 65.B master
 66column
 67.RB ( tiling
 68mode only).
 69.TP
 70.B Mod1-m
 71Maximize current
 72.BR window .
 73.TP
 74.B Mod1-Shift-[0..n]
 75Apply
 76.B nth tag
 77to current
 78.BR window .
 79.TP
 80.B Mod1-Control-Shift-[0..n]
 81Add/remove
 82.B nth tag
 83to/from current
 84.BR window .
 85.TP
 86.B Mod1-Shift-c
 87Close focused
 88.B window.
 89.TP
 90.B Mod1-space
 91Toggle between
 92.B tiled
 93and
 94.B floating
 95mode (affects
 96.BR "all windows" ).
 97.TP
 98.B Mod1-[0..n]
 99View all windows with
100.BR "tag n" .
101.TP
102.B Mod1-Control-[0..n]
103Add/remove all windows with
104.B tag n
105to/from the view.
106.TP
107.B Mod1-Shift-q
108Quit
109.B dwm.
110.SS Mouse commands
111.TP
112.B Mod1-Button1
113Move current
114.B window
115while dragging
116.RB ( floating
117mode only).
118.TP
119.B Mod1-Button2
120Zoom current
121.B window
122to the 
123.B master
124column
125.RB ( tiling
126mode only).
127.TP
128.B Mod1-Button3
129Resize current
130.B window
131while dragging
132.RB ( floating
133mode only).
134.SH CUSTOMIZATION
135.B dwm
136is customized by creating a custom config.h and (re)compiling the source
137code. This keeps it fast, secure and simple.
138.SH CAVEATS
139The status bar displays
140.B broken pipe
141when
142.B dwm
143has been started by
144.BR xdm (1),
145because it closes standard output before executing
146.BR dwm .
147.SH SEE ALSO
148.BR dmenu (1)