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
  8dwm is a dynamic window manager for X. It manages windows in tiling and
  9versatile layouts. Either layout can be applied dynamically, optimizing the
 10environment for the application in use and the task performed.
 11.P
 12In tiling layout windows are managed in a master and stacking area. The master
 13area contains the windows which currently need most attention, whereas the
 14stacking area contains all other windows. In versatile layout windows can be
 15resized and moved freely. Dialog windows are always managed versatile,
 16regardless of the layout applied.
 17.P
 18Windows are grouped by tags. Each window can be tagged with one or multiple
 19tags. Selecting certain tags displays all windows with these tags.
 20.P
 21dwm contains a small status bar which displays all available tags, the layout,
 22the title of the focused window, and the text read from standard input. A
 23versatile window is indicated with an empty square and a maximized
 24versatile window is indicated with a filled square before the windows
 25title.  The selected tags are indicated with a different color. The tags of
 26the focused window are indicated with a filled square in the top left
 27corner.  The tags which are applied to one or more windows are indicated
 28with an empty square in the top left corner.
 29.P
 30dwm draws a small border around windows to indicate the focus state.
 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 to display all windows with that tag, click on the layout
 43label toggles between tiling and versatile layout.
 44.TP
 45.B Button3
 46click on a tag label adds/removes all windows with that tag to/from the view.
 47.TP
 48.B Button4
 49click on the layout label increases the number of windows in the master area (tiling layout only).
 50.TP
 51.B Button5
 52click on the layout label decreases the number of windows in the master area (tiling layout only).
 53.TP
 54.B Mod1-Button1
 55click on a tag label applies that tag to the focused window.
 56.TP
 57.B Mod1-Button3
 58click on a tag label adds/removes that tag to/from the focused window.
 59.SS Keyboard commands
 60.TP
 61.B Mod1-Shift-Return
 62Start
 63.BR xterm (1).
 64.TP
 65.B Mod1-Return
 66Zooms/cycles current window to/from master area (tiling layout only).
 67.TP
 68.B Mod1-j
 69Focus next window.
 70.TP
 71.B Mod1-k
 72Focus previous window.
 73.TP
 74.B Mod1-l
 75Increase master area width (tiling layout only).
 76.TP
 77.B Mod1-h
 78Decrease master area width (tiling layout only).
 79.TP
 80.B Mod1-i
 81Increase the number of windows in the master area (tiling layout only).
 82.TP
 83.B Mod1-d
 84Decrease the number of windows in the master area (tiling layout only).
 85.TP
 86.B Mod1-m
 87Toggles maximization of current window (versatile layout only).
 88.TP
 89.B Mod1-Shift-[1..n]
 90Apply
 91.RB nth
 92tag to current window.
 93.TP
 94.B Mod1-Shift-0
 95Apply all tags to current window.
 96.TP
 97.B Mod1-Control-Shift-[1..n]
 98Add/remove
 99.B nth
100tag to/from current window.
101.TP
102.B Mod1-Shift-c
103Close focused window.
104.TP
105.B Mod1-space
106Toggle between tiling and versatile layout (affects all windows).
107.TP
108.B Mod1-Shift-space
109Toggle focused window between versatile and non-versatile state (tiling layout only).
110.TP
111.B Mod1-[1..n]
112View all windows with
113.BR nth
114tag.
115.TP
116.B Mod1-0
117View all windows with any tag.
118.TP
119.B Mod1-Control-[1..n]
120Add/remove all windows with
121.BR nth
122tag to/from the view.
123.TP
124.B Mod1-Shift-q
125Quit dwm.
126.SS Mouse commands
127.TP
128.B Mod1-Button1
129Move current window while dragging (versatile layout only).
130.TP
131.B Mod1-Button2
132Zooms/cycles current window to/from master area (tiling layout only).
133.TP
134.B Mod1-Button3
135Resize current window while dragging (versatile layout only).
136.SH CUSTOMIZATION
137dwm is customized by creating a custom config.h and (re)compiling the source
138code. This keeps it fast, secure and simple.
139.SH SEE ALSO
140.BR dmenu (1)
141.SH BUGS
142The status bar may display
143.BR "EOF"
144when dwm has been started by an X session manager like
145.BR xdm (1),
146because those close standard output before executing dwm.
147.P
148Java applications which use the XToolkit/XAWT backend may draw grey windows
149only. The XToolkit/XAWT backend breaks ICCCM-compliance in recent JDK 1.5 and early
150JDK 1.6 versions, because it assumes a reparenting window manager. As a workaround
151you can use JDK 1.4 (which doesn't contain the XToolkit/XAWT backend) or you
152can set the following environment variable (to use the older Motif
153backend instead):
154.BR AWT_TOOLKIT=MToolkit .