1.TH DWM 1 dwm-0.1
  2.SH NAME
  3dwm \- dynamic window manager
  4.SH SYNOPSIS
  5.B dwm
  6.RB [ \-v ]
  7.SH DESCRIPTION
  8.SS Overview
  9.B dwm
 10is a dynamic window manager for X11. It consists of a small status bar at the
 11top of the screen and arranges windows in either a tiled or floating mode.
 12.P
 13If 
 14.B dwm
 15is in tiled mode, it consists of two columns. The left master column
 16contains only one window per time, the right column contains all other windows 
 17in a stack. In tiled mode
 18.B dwm
 19.B don't
 20handles incremental resizals, some terminal programs like
 21.B xterm
 22may not work correctly with this in tiled mode.
 23.P
 24If
 25.B dwm
 26is in floating mode, it arranges all windows with the reqyested geometry and
 27allows the user to move or resize them. Some windows, like
 28dialog windows, are treated floating even if
 29.B dwm
 30is in tiled mode. In floating mode
 31.B dwm
 32handles incremental resizals.
 33.P
 34Windows are grouped by tags. You can view all windows with a specific tag per
 35time.  However, each window is allowed to contain more than one tag, which
 36allows to make windows visible in all views.
 37.P
 38.B dwm
 39reads from
 40.I stdin
 41to display status text, if written.
 42.P
 43.B dwm
 44draws 1-pixel borders around windows to indicate the focus state and save as
 45much screen real estate as possible. Unfocused windows contain a small bar
 46in front of the window indicating the tags and the window title.
 47.SS Options
 48.TP
 49.B \-v
 50prints version information to
 51.I stdout
 52, then exits.
 53.SS Customization
 54.B dwm
 55is customized through editing its source code. It is assumed that
 56dwm users are high experienced users who know how a window manager works
 57and who are able to patch
 58.B dwm
 59for their needs. This keeps
 60.B dwm
 61fast, secure and simple, because it does not process any input data, except
 62window properties and the status text read from
 63.I stdin .
 64.SS Default Key Bindings
 65.TP 16
 66.I Key	
 67.I Action
 68.TP
 69.B Mod1-Return
 70Zoom
 71.B window
 72to the 
 73.B master
 74track
 75.TP
 76.B Mod1-k
 77Focus previous
 78.B window
 79.TP
 80.B Mod1-j
 81Focus next
 82.B window
 83.TP
 84.B Mod1-m
 85Maximize current
 86.B window
 87.TP
 88.B Mod1-[0..n]
 89Focus
 90.B nth
 91tag
 92.TP
 93.B Mod1-space
 94(Re-)arrange
 95.B all
 96windows tiled
 97.TP
 98.B Mod1-Shift-space
 99(Re-)arrange
100.B all
101windows floating
102.TP
103.B Mod1-Shift-[0..n]
104Apply
105.B nth
106tag to current
107.B window
108.TP
109.B Mod1-Shift-q
110Quit
111.B dwm
112.TP
113.B Mod1-Shift-Return
114Start
115.B terminal
116.TP
117.B Mod1-Shift-w
118Start
119.B web browser
120.TP
121.B Mod1-Shift-l
122Lock
123.B screen
124.TP
125.B Control-[0..n]
126Append
127.B nth
128tag to cureent
129.B window
130.SS Default Mouse Bindings
131.TP
132.B Mod1-Button1
133Moves current
134.B window
135while dragging
136.TP
137.B Mod1-Button2
138Lowers current
139.B window
140.TP
141.B Mod1-Button3
142Resizes current
143.B window
144while dragging
145.SH BUGS
146Some terminal programs do not behave correctly in tiled mode, because
147incremental resizals are ignored to use maximum screen real estate. You can
148patch the code to fix this.