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