author | Anselm R.Garbe <arg@10ksloc.org> |
Mon, 14 Aug 2006 08:52:15 +0200 | |
changeset 269 | bf6792e3e700 |
parent 267 | 8a8ea74e1b87 |
child 270 | dacd3f3c5823 |
permissions | -rw-r--r-- |
212 | 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 |
|
38 | 8 |
.B dwm |
82 | 9 |
is a dynamic window manager for X11. It manages windows in tiling and floating |
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
|
10 |
modes. Either mode can be applied dynamically, optimizing the environment for |
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
|
11 |
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
|
12 |
.P |
82 | 13 |
In tiling mode windows are managed in a master and stacking column. The master |
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
|
14 |
column contains the window which currently needs most attention, whereas the |
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
|
15 |
stacking column contains all other windows. In floating mode windows can be |
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
|
16 |
resized and moved freely. Dialog windows are always managed floating, |
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
|
17 |
regardless of the mode selected. |
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 |
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
|
20 |
tags. Selecting a certain tag for viewing will display all windows with that |
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
|
21 |
tag. |
79
aabebd6e61f3
fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents:
68
diff
changeset
|
22 |
.P |
83 | 23 |
.B dwm |
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
|
24 |
has a small status bar which displays the text read from standard |
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
|
25 |
input, if written. Besides that, it displays all available tags, and the title |
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
|
26 |
of the focused window. It draws a 1-pixel border around windows to |
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
|
27 |
indicate the focus state. Unfocused windows contain a small bar in front of |
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
|
28 |
them displaying their tags and title. |
80
8125f908c80c
several additions in mouse handling ;)
Anselm R. Garbe <garbeam@wmii.de>
parents:
79
diff
changeset
|
29 |
.SH OPTIONS |
0 | 30 |
.TP |
31 |
.B \-v |
|
80
8125f908c80c
several additions in mouse handling ;)
Anselm R. Garbe <garbeam@wmii.de>
parents:
79
diff
changeset
|
32 |
prints version information to standard output, then exits. |
82 | 33 |
.SH USAGE |
256 | 34 |
.SS Status bar |
35 |
.TP |
|
259
d661ecce0c75
applied Sanders fixes to dwm.1
Anselm R.Garbe <arg@10ksloc.org>
parents:
258
diff
changeset
|
36 |
.B Standard input |
d661ecce0c75
applied Sanders fixes to dwm.1
Anselm R.Garbe <arg@10ksloc.org>
parents:
258
diff
changeset
|
37 |
is read and displayed in the status text area. |
256 | 38 |
.TP |
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
|
39 |
.B Button[1,3] |
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
|
40 |
click on a tag label focuses that |
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
|
41 |
.B tag. |
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
|
42 |
.TP |
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
|
43 |
.B Button2 |
264
afcea99a4f3f
updated man page, added CAVEATS section
Anselm R.Garbe <arg@10ksloc.org>
parents:
262
diff
changeset
|
44 |
click on a tag label toggles that |
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 |
.B tag. |
256 | 46 |
.SS Keyboard commands |
55 | 47 |
.TP |
48 |
.B Mod1-Return |
|
238 | 49 |
Zoom current |
55 | 50 |
.B window |
51 |
to the |
|
52 |
.B master |
|
219
d8e508716aa8
added a trailing '.' to shortcut descriptions in dwm(1)
arg@10ksloc.org
parents:
212
diff
changeset
|
53 |
column. |
55 | 54 |
.TP |
160 | 55 |
.B Mod1-j |
56 |
Focus next |
|
219
d8e508716aa8
added a trailing '.' to shortcut descriptions in dwm(1)
arg@10ksloc.org
parents:
212
diff
changeset
|
57 |
.B window. |
160 | 58 |
.TP |
55 | 59 |
.B Mod1-k |
60 |
Focus previous |
|
219
d8e508716aa8
added a trailing '.' to shortcut descriptions in dwm(1)
arg@10ksloc.org
parents:
212
diff
changeset
|
61 |
.B window. |
55 | 62 |
.TP |
63 |
.B Mod1-m |
|
64 |
Maximize current |
|
219
d8e508716aa8
added a trailing '.' to shortcut descriptions in dwm(1)
arg@10ksloc.org
parents:
212
diff
changeset
|
65 |
.B window. |
55 | 66 |
.TP |
67 |
.B Mod1-[0..n] |
|
68 |
Focus |
|
219
d8e508716aa8
added a trailing '.' to shortcut descriptions in dwm(1)
arg@10ksloc.org
parents:
212
diff
changeset
|
69 |
.B nth tag. |
55 | 70 |
.TP |
71 |
.B Mod1-space |
|
143 | 72 |
Toggle between |
73 |
.B tiled |
|
74 |
and |
|
75 |
.B floating |
|
76 |
mode (affects |
|
219
d8e508716aa8
added a trailing '.' to shortcut descriptions in dwm(1)
arg@10ksloc.org
parents:
212
diff
changeset
|
77 |
.BR "all windows" ). |
56 | 78 |
.TP |
79 |
.B Mod1-Shift-[0..n] |
|
80 |
Apply |
|
160 | 81 |
.B nth tag |
82 |
to current |
|
219
d8e508716aa8
added a trailing '.' to shortcut descriptions in dwm(1)
arg@10ksloc.org
parents:
212
diff
changeset
|
83 |
.B window. |
56 | 84 |
.TP |
258
fb5612299c57
fixed dwm.1, added Mod1-Shift-c (was missing for an odd reason)
Anselm R.Garbe <arg@10ksloc.org>
parents:
256
diff
changeset
|
85 |
.B Mod1-Shift-c |
fb5612299c57
fixed dwm.1, added Mod1-Shift-c (was missing for an odd reason)
Anselm R.Garbe <arg@10ksloc.org>
parents:
256
diff
changeset
|
86 |
Close focused |
fb5612299c57
fixed dwm.1, added Mod1-Shift-c (was missing for an odd reason)
Anselm R.Garbe <arg@10ksloc.org>
parents:
256
diff
changeset
|
87 |
.B window. |
fb5612299c57
fixed dwm.1, added Mod1-Shift-c (was missing for an odd reason)
Anselm R.Garbe <arg@10ksloc.org>
parents:
256
diff
changeset
|
88 |
.TP |
56 | 89 |
.B Mod1-Shift-q |
90 |
Quit |
|
219
d8e508716aa8
added a trailing '.' to shortcut descriptions in dwm(1)
arg@10ksloc.org
parents:
212
diff
changeset
|
91 |
.B dwm. |
56 | 92 |
.TP |
93 |
.B Mod1-Shift-Return |
|
94 |
Start |
|
219
d8e508716aa8
added a trailing '.' to shortcut descriptions in dwm(1)
arg@10ksloc.org
parents:
212
diff
changeset
|
95 |
.B terminal. |
56 | 96 |
.TP |
131
65efe27cbf3d
preparing 0.6 which will be available in the evening after sanders patch approx.
arg@10ksloc.org
parents:
123
diff
changeset
|
97 |
.B Mod1-Control-[0..n] |
264
afcea99a4f3f
updated man page, added CAVEATS section
Anselm R.Garbe <arg@10ksloc.org>
parents:
262
diff
changeset
|
98 |
Toggle |
afcea99a4f3f
updated man page, added CAVEATS section
Anselm R.Garbe <arg@10ksloc.org>
parents:
262
diff
changeset
|
99 |
.B nth tag. |
afcea99a4f3f
updated man page, added CAVEATS section
Anselm R.Garbe <arg@10ksloc.org>
parents:
262
diff
changeset
|
100 |
.TP |
afcea99a4f3f
updated man page, added CAVEATS section
Anselm R.Garbe <arg@10ksloc.org>
parents:
262
diff
changeset
|
101 |
.B Mod1-Control-Shift-[0..n] |
56 | 102 |
Append |
160 | 103 |
.B nth tag |
104 |
to current |
|
219
d8e508716aa8
added a trailing '.' to shortcut descriptions in dwm(1)
arg@10ksloc.org
parents:
212
diff
changeset
|
105 |
.B window. |
256 | 106 |
.SS Mouse commands |
82 | 107 |
.TP |
59
5d4653de9a1c
implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents:
58
diff
changeset
|
108 |
.B Mod1-Button1 |
238 | 109 |
Move current |
59
5d4653de9a1c
implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents:
58
diff
changeset
|
110 |
.B window |
219
d8e508716aa8
added a trailing '.' to shortcut descriptions in dwm(1)
arg@10ksloc.org
parents:
212
diff
changeset
|
111 |
while dragging. |
59
5d4653de9a1c
implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents:
58
diff
changeset
|
112 |
.TP |
238 | 113 |
.B Mod1-Button2 |
114 |
Zoom current |
|
115 |
.B window |
|
116 |
to the |
|
117 |
.B master |
|
118 |
column. |
|
119 |
.TP |
|
59
5d4653de9a1c
implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents:
58
diff
changeset
|
120 |
.B Mod1-Button3 |
238 | 121 |
Resize current |
59
5d4653de9a1c
implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents:
58
diff
changeset
|
122 |
.B window |
219
d8e508716aa8
added a trailing '.' to shortcut descriptions in dwm(1)
arg@10ksloc.org
parents:
212
diff
changeset
|
123 |
while dragging. |
82 | 124 |
.SH CUSTOMIZATION |
125 |
.B dwm |
|
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
|
126 |
is customized by creating a custom config.h and (re)compiling the source |
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
|
127 |
code. This keeps it fast, secure and simple. |
264
afcea99a4f3f
updated man page, added CAVEATS section
Anselm R.Garbe <arg@10ksloc.org>
parents:
262
diff
changeset
|
128 |
.SH CAVEATS |
afcea99a4f3f
updated man page, added CAVEATS section
Anselm R.Garbe <arg@10ksloc.org>
parents:
262
diff
changeset
|
129 |
The status bar displays |
afcea99a4f3f
updated man page, added CAVEATS section
Anselm R.Garbe <arg@10ksloc.org>
parents:
262
diff
changeset
|
130 |
.BR "broken pipe" |
afcea99a4f3f
updated man page, added CAVEATS section
Anselm R.Garbe <arg@10ksloc.org>
parents:
262
diff
changeset
|
131 |
when |
afcea99a4f3f
updated man page, added CAVEATS section
Anselm R.Garbe <arg@10ksloc.org>
parents:
262
diff
changeset
|
132 |
.B dwm |
afcea99a4f3f
updated man page, added CAVEATS section
Anselm R.Garbe <arg@10ksloc.org>
parents:
262
diff
changeset
|
133 |
has been started by |
afcea99a4f3f
updated man page, added CAVEATS section
Anselm R.Garbe <arg@10ksloc.org>
parents:
262
diff
changeset
|
134 |
.BR xdm (1), |
afcea99a4f3f
updated man page, added CAVEATS section
Anselm R.Garbe <arg@10ksloc.org>
parents:
262
diff
changeset
|
135 |
because it closes standard output before executing |
afcea99a4f3f
updated man page, added CAVEATS section
Anselm R.Garbe <arg@10ksloc.org>
parents:
262
diff
changeset
|
136 |
.B dwm. |
201 | 137 |
.SH SEE ALSO |
138 |
.BR dmenu (1) |