author | Anselm R Garbe <garbeam@gmail.com> |
Mon, 18 Aug 2008 08:57:34 +0100 | |
changeset 1322 | 3d39dc3001cc |
parent 1300 | f07372537698 |
child 1370 | 6d6ed7a9183c |
permissions | -rw-r--r-- |
1019 | 1 |
.TH DWM 1 dwm\-VERSION |
0 | 2 |
.SH NAME |
39 | 3 |
dwm \- dynamic window manager |
0 | 4 |
.SH SYNOPSIS |
38 | 5 |
.B dwm |
0 | 6 |
.RB [ \-v ] |
7 |
.SH DESCRIPTION |
|
1121
898952a1689d
renamed maximise to monocle again.
Anselm R Garbe <garbeam@gmail.com>
parents:
1117
diff
changeset
|
8 |
dwm is a dynamic window manager for X. It manages windows in tiled, monocle |
1117
fac7660be3de
renamed monocle into maxmise, documented the keybindings in dwm(1)
anselm@anselm1
parents:
1071
diff
changeset
|
9 |
and floating layouts. Either layout can be applied dynamically, optimising the |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
10 |
environment for the application in use and the task performed. |
79
aabebd6e61f3
fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents:
68
diff
changeset
|
11 |
.P |
1133 | 12 |
In tiled layouts windows are managed in a master and stacking area. The master |
939
a1ac5930ba2f
removed VRATIO, NMASTER, inc*(), renamed HRATIO into MASTER, see mailinglist for details
Anselm R. Garbe <garbeam@gmail.com>
parents:
936
diff
changeset
|
13 |
area contains the window which currently needs most attention, whereas the |
1121
898952a1689d
renamed maximise to monocle again.
Anselm R Garbe <garbeam@gmail.com>
parents:
1117
diff
changeset
|
14 |
stacking area contains all other windows. In monocle layout all windows are |
1117
fac7660be3de
renamed monocle into maxmise, documented the keybindings in dwm(1)
anselm@anselm1
parents:
1071
diff
changeset
|
15 |
maximised to the screen size. In floating layout windows can be resized and |
fac7660be3de
renamed monocle into maxmise, documented the keybindings in dwm(1)
anselm@anselm1
parents:
1071
diff
changeset
|
16 |
moved freely. Dialog windows are always managed floating, regardless of the |
fac7660be3de
renamed monocle into maxmise, documented the keybindings in dwm(1)
anselm@anselm1
parents:
1071
diff
changeset
|
17 |
layout applied. |
79
aabebd6e61f3
fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents:
68
diff
changeset
|
18 |
.P |
174
48c820470858
applied Sanders doc changes, added a PHONY line and changed the output of config.h creation somewhat
arg@10ksloc.org
parents:
171
diff
changeset
|
19 |
Windows are grouped by tags. Each window can be tagged with one or multiple |
470 | 20 |
tags. Selecting certain tags displays all windows with these tags. |
79
aabebd6e61f3
fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents:
68
diff
changeset
|
21 |
.P |
782
92862ab407d5
introduced Layout struct
Anselm R. Garbe <arg@suckless.org>
parents:
749
diff
changeset
|
22 |
dwm contains a small status bar which displays all available tags, the layout, |
818
013954d9fe7a
reusing drawsquare for client title, empty square before title means versatile window, filled square before title means versatile maximized window.
Anselm R. Garbe <arg@suckless.org>
parents:
817
diff
changeset
|
23 |
the title of the focused window, and the text read from standard input. A |
1117
fac7660be3de
renamed monocle into maxmise, documented the keybindings in dwm(1)
anselm@anselm1
parents:
1071
diff
changeset
|
24 |
floating window is indicated with an empty square and a maximised |
837
123231b9eb87
renamed untiled into floating, keeping tiled instead of tiling (afaik tiled sounds more correct) - English speakers convinced me
Anselm R. Garbe <arg@suckless.org>
parents:
836
diff
changeset
|
25 |
floating window is indicated with a filled square before the windows |
818
013954d9fe7a
reusing drawsquare for client title, empty square before title means versatile window, filled square before title means versatile maximized window.
Anselm R. Garbe <arg@suckless.org>
parents:
817
diff
changeset
|
26 |
title. The selected tags are indicated with a different color. The tags of |
013954d9fe7a
reusing drawsquare for client title, empty square before title means versatile window, filled square before title means versatile maximized window.
Anselm R. Garbe <arg@suckless.org>
parents:
817
diff
changeset
|
27 |
the focused window are indicated with a filled square in the top left |
817
90435b444620
dwm draws a small caret before the client title if it's a versatile client
Anselm R. Garbe <arg@suckless.org>
parents:
813
diff
changeset
|
28 |
corner. The tags which are applied to one or more windows are indicated |
90435b444620
dwm draws a small caret before the client title if it's a versatile client
Anselm R. Garbe <arg@suckless.org>
parents:
813
diff
changeset
|
29 |
with an empty square in the top left corner. |
316
d69cdb180a3e
small changes to dwm.1, rearranged order within main event loop
Anselm R.Garbe <arg@10ksloc.org>
parents:
293
diff
changeset
|
30 |
.P |
700
f05c825db96b
moved BORDERPX to config.*.h
Anselm R. Garbe <arg@suckless.org>
parents:
687
diff
changeset
|
31 |
dwm draws a small border around windows to indicate the focus state. |
80
8125f908c80c
several additions in mouse handling ;)
Anselm R. Garbe <garbeam@wmii.de>
parents:
79
diff
changeset
|
32 |
.SH OPTIONS |
0 | 33 |
.TP |
34 |
.B \-v |
|
80
8125f908c80c
several additions in mouse handling ;)
Anselm R. Garbe <garbeam@wmii.de>
parents:
79
diff
changeset
|
35 |
prints version information to standard output, then exits. |
82 | 36 |
.SH USAGE |
256 | 37 |
.SS Status bar |
38 |
.TP |
|
259
d661ecce0c75
applied Sanders fixes to dwm.1
Anselm R.Garbe <arg@10ksloc.org>
parents:
258
diff
changeset
|
39 |
.B Standard input |
d661ecce0c75
applied Sanders fixes to dwm.1
Anselm R.Garbe <arg@10ksloc.org>
parents:
258
diff
changeset
|
40 |
is read and displayed in the status text area. |
256 | 41 |
.TP |
288
b7865e6feef2
applied sanders man page patch, removed button2 from bar click
Anselm R.Garbe <arg@10ksloc.org>
parents:
270
diff
changeset
|
42 |
.B Button1 |
782
92862ab407d5
introduced Layout struct
Anselm R. Garbe <arg@suckless.org>
parents:
749
diff
changeset
|
43 |
click on a tag label to display all windows with that tag, click on the layout |
837
123231b9eb87
renamed untiled into floating, keeping tiled instead of tiling (afaik tiled sounds more correct) - English speakers convinced me
Anselm R. Garbe <arg@suckless.org>
parents:
836
diff
changeset
|
44 |
label toggles between tiled and floating layout. |
262
d659a2dce2b5
implemented viewextend and added M-S-C-n shortcuts for extending the current view... updated man page (works great!) nice feature
Anselm R.Garbe <arg@10ksloc.org>
parents:
259
diff
changeset
|
45 |
.TP |
270
dacd3f3c5823
implemented restack behavior (floats are on top in tiled mode)
Anselm R.Garbe <arg@10ksloc.org>
parents:
267
diff
changeset
|
46 |
.B Button3 |
530
451f19d48845
removed the stack position stuff
Anselm R. Garbe <arg@10kloc.org>
parents:
525
diff
changeset
|
47 |
click on a tag label adds/removes all windows with that tag to/from the view. |
398 | 48 |
.TP |
847 | 49 |
.B Mod1\-Button1 |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
50 |
click on a tag label applies that tag to the focused window. |
398 | 51 |
.TP |
847 | 52 |
.B Mod1\-Button3 |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
53 |
click on a tag label adds/removes that tag to/from the focused window. |
256 | 54 |
.SS Keyboard commands |
55 | 55 |
.TP |
847 | 56 |
.B Mod1\-Shift\-Return |
293 | 57 |
Start |
838
168547cc501b
well I agree to several people claiming h/j/k/l is the better default than Tab/S-Tab/g/s for focus and master resizing
Anselm R. Garbe <arg@suckless.org>
parents:
837
diff
changeset
|
58 |
.BR xterm. |
293 | 59 |
.TP |
1215
840fd59e3141
make it easier for the user, if Xinerama support is given, always use the screen 0 as window area/bar area, everything else can be used for floating clients
Anselm R Garbe <garbeam@gmail.com>
parents:
1205
diff
changeset
|
60 |
.B Mod1\-b |
840fd59e3141
make it easier for the user, if Xinerama support is given, always use the screen 0 as window area/bar area, everything else can be used for floating clients
Anselm R Garbe <garbeam@gmail.com>
parents:
1205
diff
changeset
|
61 |
Toggles bar on and off. |
840fd59e3141
make it easier for the user, if Xinerama support is given, always use the screen 0 as window area/bar area, everything else can be used for floating clients
Anselm R Garbe <garbeam@gmail.com>
parents:
1205
diff
changeset
|
62 |
.TP |
1289 | 63 |
.B Mod1\-t |
64 |
Sets tiled layout. |
|
65 |
.TP |
|
66 |
.B Mod1\-f |
|
67 |
Sets floating layout. |
|
68 |
.TP |
|
1300
f07372537698
applied James Turner's dwm.1 patch, thanks James!
Anselm R Garbe <garbeam@gmail.com>
parents:
1289
diff
changeset
|
69 |
.B Mod1\-m |
1289 | 70 |
Sets monocle layout. |
71 |
.TP |
|
1159
34c88d74dff0
setlayout and setgeom are now togglable again
Anselm R Garbe <garbeam@gmail.com>
parents:
1133
diff
changeset
|
72 |
.B Mod1\-space |
1289 | 73 |
Toggles between current and previous layout. |
881
709b1538e1af
added new Mod1-b functionality to dwm(1)
Anselm R. Garbe <arg@suckless.org>
parents:
876
diff
changeset
|
74 |
.TP |
847 | 75 |
.B Mod1\-j |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
76 |
Focus next window. |
293 | 77 |
.TP |
847 | 78 |
.B Mod1\-k |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
79 |
Focus previous window. |
293 | 80 |
.TP |
1160
bf37ef388dd6
revival of mfact and setmfact
Anselm R Garbe <garbeam@gmail.com>
parents:
1159
diff
changeset
|
81 |
.B Mod1\-h |
bf37ef388dd6
revival of mfact and setmfact
Anselm R Garbe <garbeam@gmail.com>
parents:
1159
diff
changeset
|
82 |
Decrease master area size. |
bf37ef388dd6
revival of mfact and setmfact
Anselm R Garbe <garbeam@gmail.com>
parents:
1159
diff
changeset
|
83 |
.TP |
bf37ef388dd6
revival of mfact and setmfact
Anselm R Garbe <garbeam@gmail.com>
parents:
1159
diff
changeset
|
84 |
.B Mod1\-l |
bf37ef388dd6
revival of mfact and setmfact
Anselm R Garbe <garbeam@gmail.com>
parents:
1159
diff
changeset
|
85 |
Increase master area size. |
bf37ef388dd6
revival of mfact and setmfact
Anselm R Garbe <garbeam@gmail.com>
parents:
1159
diff
changeset
|
86 |
.TP |
1133 | 87 |
.B Mod1\-Return |
88 |
Zooms/cycles focused window to/from master area (tiled layouts only). |
|
89 |
.TP |
|
90 |
.B Mod1\-Shift\-c |
|
91 |
Close focused window. |
|
92 |
.TP |
|
93 |
.B Mod1\-Shift\-space |
|
94 |
Toggle focused window between tiled and floating state. |
|
95 |
.TP |
|
96 |
.B Mod1\-Tab |
|
97 |
Toggles to the previously selected tags. |
|
98 |
.TP |
|
847 | 99 |
.B Mod1\-Shift\-[1..n] |
293 | 100 |
Apply |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
101 |
.RB nth |
1133 | 102 |
tag to focused window. |
293 | 103 |
.TP |
847 | 104 |
.B Mod1\-Shift\-0 |
1133 | 105 |
Apply all tags to focused window. |
594
f7dcd3ac8d6f
removed viewall(), replaced with view(-1); added tag(-1) to tag a client with all tags (new key combo MODKEY-Shift-0)
arg@mig29
parents:
592
diff
changeset
|
106 |
.TP |
847 | 107 |
.B Mod1\-Control\-Shift\-[1..n] |
293 | 108 |
Add/remove |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
109 |
.B nth |
1133 | 110 |
tag to/from focused window. |
585 | 111 |
.TP |
847 | 112 |
.B Mod1\-[1..n] |
293 | 113 |
View all windows with |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
114 |
.BR nth |
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
115 |
tag. |
56 | 116 |
.TP |
847 | 117 |
.B Mod1\-0 |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
118 |
View all windows with any tag. |
395
7528080beb0e
added viewall to mainstream (only Ross Mohns version, not the toggle)
Anselm R. Garbe <arg@10kloc.org>
parents:
394
diff
changeset
|
119 |
.TP |
847 | 120 |
.B Mod1\-Control\-[1..n] |
288
b7865e6feef2
applied sanders man page patch, removed button2 from bar click
Anselm R.Garbe <arg@10ksloc.org>
parents:
270
diff
changeset
|
121 |
Add/remove all windows with |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
122 |
.BR nth |
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
123 |
tag to/from the view. |
264
afcea99a4f3f
updated man page, added CAVEATS section
Anselm R.Garbe <arg@10ksloc.org>
parents:
262
diff
changeset
|
124 |
.TP |
847 | 125 |
.B Mod1\-Shift\-q |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
126 |
Quit dwm. |
256 | 127 |
.SS Mouse commands |
82 | 128 |
.TP |
847 | 129 |
.B Mod1\-Button1 |
1133 | 130 |
Move focused window while dragging. Tiled windows will be toggled to the floating state. |
59
5d4653de9a1c
implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents:
58
diff
changeset
|
131 |
.TP |
847 | 132 |
.B Mod1\-Button2 |
1222 | 133 |
Toggles focused window between floating and tiled state. |
238 | 134 |
.TP |
847 | 135 |
.B Mod1\-Button3 |
1133 | 136 |
Resize focused window while dragging. Tiled windows will be toggled to the floating state. |
82 | 137 |
.SH CUSTOMIZATION |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
138 |
dwm is customized by creating a custom config.h and (re)compiling the source |
174
48c820470858
applied Sanders doc changes, added a PHONY line and changed the output of config.h creation somewhat
arg@10ksloc.org
parents:
171
diff
changeset
|
139 |
code. This keeps it fast, secure and simple. |
724
583c0adeee79
regarding to http://plan9.bell-labs.com/sources/contrib/rsc/man.ps the BUGS section should appear after SEE ALSO section.
Anselm R. Garbe <arg@suckless.org>
parents:
723
diff
changeset
|
140 |
.SH SEE ALSO |
583c0adeee79
regarding to http://plan9.bell-labs.com/sources/contrib/rsc/man.ps the BUGS section should appear after SEE ALSO section.
Anselm R. Garbe <arg@suckless.org>
parents:
723
diff
changeset
|
141 |
.BR dmenu (1) |
723
251047bc6129
renamed CAVEATS into BUGS
Anselm R. Garbe <arg@suckless.org>
parents:
700
diff
changeset
|
142 |
.SH BUGS |
347 | 143 |
The status bar may display |
633
7209e355762c
fixed man page, status bar displays EOF instead of "broken pipe"
arg@mig29
parents:
632
diff
changeset
|
144 |
.BR "EOF" |
632 | 145 |
when dwm has been started by an X session manager like |
264
afcea99a4f3f
updated man page, added CAVEATS section
Anselm R.Garbe <arg@10ksloc.org>
parents:
262
diff
changeset
|
146 |
.BR xdm (1), |
632 | 147 |
because those close standard output before executing dwm. |
148 |
.P |
|
149 |
Java applications which use the XToolkit/XAWT backend may draw grey windows |
|
150 |
only. The XToolkit/XAWT backend breaks ICCCM-compliance in recent JDK 1.5 and early |
|
634 | 151 |
JDK 1.6 versions, because it assumes a reparenting window manager. As a workaround |
152 |
you can use JDK 1.4 (which doesn't contain the XToolkit/XAWT backend) or you |
|
153 |
can set the following environment variable (to use the older Motif |
|
632 | 154 |
backend instead): |
155 |
.BR AWT_TOOLKIT=MToolkit . |
|
876
22c923f7c2d1
added the GTK Save-As bug report to BUGS section of dwm(1)
Anselm R. Garbe <arg@suckless.org>
parents:
847
diff
changeset
|
156 |
.P |
1133 | 157 |
GTK 2.10.9+ versions contain a broken |
876
22c923f7c2d1
added the GTK Save-As bug report to BUGS section of dwm(1)
Anselm R. Garbe <arg@suckless.org>
parents:
847
diff
changeset
|
158 |
.BR Save\-As |
22c923f7c2d1
added the GTK Save-As bug report to BUGS section of dwm(1)
Anselm R. Garbe <arg@suckless.org>
parents:
847
diff
changeset
|
159 |
file dialog implementation, |
22c923f7c2d1
added the GTK Save-As bug report to BUGS section of dwm(1)
Anselm R. Garbe <arg@suckless.org>
parents:
847
diff
changeset
|
160 |
which requests to reconfigure its window size in an endless loop. However, its |
22c923f7c2d1
added the GTK Save-As bug report to BUGS section of dwm(1)
Anselm R. Garbe <arg@suckless.org>
parents:
847
diff
changeset
|
161 |
window is still respondable during this state, so you can simply ignore the flicker |
22c923f7c2d1
added the GTK Save-As bug report to BUGS section of dwm(1)
Anselm R. Garbe <arg@suckless.org>
parents:
847
diff
changeset
|
162 |
until a new GTK version appears, which will fix this bug, approximately |
22c923f7c2d1
added the GTK Save-As bug report to BUGS section of dwm(1)
Anselm R. Garbe <arg@suckless.org>
parents:
847
diff
changeset
|
163 |
GTK 2.10.12+ versions. |