Mercurial > dwm-meillo
annotate dwm.1 @ 443:548084f8d92e
this patch keeps track of global z-layer order of clients which are floating or if floating mode is enabled
| author | Anselm R. Garbe <arg@10kloc.org> |
|---|---|
| date | Wed, 06 Sep 2006 17:31:52 +0200 |
| parents | ca2d99d8b8fc |
| children | 48038934d05d |
| rev | line source |
|---|---|
| 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 |
|
316
d69cdb180a3e
small changes to dwm.1, rearranged order within main event loop
Anselm R.Garbe <arg@10ksloc.org>
parents:
293
diff
changeset
|
9 is a dynamic window manager for X. 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 |
| 364 | 24 contains a small status bar which displays all available tags, the mode, the |
| 25 title of the focused window, and the text read from standard input. The tags of | |
| 26 the focused window are highlighted with a small point. | |
|
316
d69cdb180a3e
small changes to dwm.1, rearranged order within main event loop
Anselm R.Garbe <arg@10ksloc.org>
parents:
293
diff
changeset
|
27 .P |
| 346 | 28 .B dwm |
| 29 draws a 1-pixel border around windows to indicate the focus state. | |
| 342 | 30 Unfocused windows contain a small bar in front of them displaying their title. |
|
80
8125f908c80c
several additions in mouse handling ;)
Anselm R. Garbe <garbeam@wmii.de>
parents:
79
diff
changeset
|
31 .SH OPTIONS |
| 0 | 32 .TP |
| 33 .B \-v | |
|
80
8125f908c80c
several additions in mouse handling ;)
Anselm R. Garbe <garbeam@wmii.de>
parents:
79
diff
changeset
|
34 prints version information to standard output, then exits. |
| 82 | 35 .SH USAGE |
| 256 | 36 .SS Status bar |
| 37 .TP | |
|
259
d661ecce0c75
applied Sanders fixes to dwm.1
Anselm R.Garbe <arg@10ksloc.org>
parents:
258
diff
changeset
|
38 .B Standard input |
|
d661ecce0c75
applied Sanders fixes to dwm.1
Anselm R.Garbe <arg@10ksloc.org>
parents:
258
diff
changeset
|
39 is read and displayed in the status text area. |
| 256 | 40 .TP |
|
288
b7865e6feef2
applied sanders man page patch, removed button2 from bar click
Anselm R.Garbe <arg@10ksloc.org>
parents:
270
diff
changeset
|
41 .B Button1 |
|
b7865e6feef2
applied sanders man page patch, removed button2 from bar click
Anselm R.Garbe <arg@10ksloc.org>
parents:
270
diff
changeset
|
42 click on a tag label views all windows with that |
|
371
fc9d35252ab4
applied sanders somepatches.patch
Anselm R. Garbe <arg@10kloc.org>
parents:
364
diff
changeset
|
43 .BR tag , |
|
fc9d35252ab4
applied sanders somepatches.patch
Anselm R. Garbe <arg@10kloc.org>
parents:
364
diff
changeset
|
44 click on the mode label toggles between |
|
fc9d35252ab4
applied sanders somepatches.patch
Anselm R. Garbe <arg@10kloc.org>
parents:
364
diff
changeset
|
45 .B tiled |
|
fc9d35252ab4
applied sanders somepatches.patch
Anselm R. Garbe <arg@10kloc.org>
parents:
364
diff
changeset
|
46 and |
|
fc9d35252ab4
applied sanders somepatches.patch
Anselm R. Garbe <arg@10kloc.org>
parents:
364
diff
changeset
|
47 .B floating |
|
fc9d35252ab4
applied sanders somepatches.patch
Anselm R. Garbe <arg@10kloc.org>
parents:
364
diff
changeset
|
48 mode. |
|
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
|
49 .TP |
|
270
dacd3f3c5823
implemented restack behavior (floats are on top in tiled mode)
Anselm R.Garbe <arg@10ksloc.org>
parents:
267
diff
changeset
|
50 .B Button3 |
|
288
b7865e6feef2
applied sanders man page patch, removed button2 from bar click
Anselm R.Garbe <arg@10ksloc.org>
parents:
270
diff
changeset
|
51 click on a tag label adds/removes all windows with that |
|
b7865e6feef2
applied sanders man page patch, removed button2 from bar click
Anselm R.Garbe <arg@10ksloc.org>
parents:
270
diff
changeset
|
52 .B tag |
|
b7865e6feef2
applied sanders man page patch, removed button2 from bar click
Anselm R.Garbe <arg@10ksloc.org>
parents:
270
diff
changeset
|
53 to/from the view. |
| 398 | 54 .TP |
| 55 .B Mod1-Button1 | |
| 56 click on a tag label applies that | |
| 57 .B tag | |
| 58 to the focused | |
| 59 .BR window . | |
| 60 .TP | |
| 61 .B Mod1-Button3 | |
| 62 click on a tag label adds/removes that | |
| 63 .B tag | |
| 64 to/from the focused | |
| 65 .BR window . | |
| 256 | 66 .SS Keyboard commands |
| 55 | 67 .TP |
| 293 | 68 .B Mod1-Shift-Return |
| 69 Start | |
| 70 .BR xterm (1). | |
| 71 .TP | |
| 72 .B Mod1-Tab | |
| 73 Focus next | |
| 74 .BR window . | |
| 75 .TP | |
| 76 .B Mod1-Shift-Tab | |
| 77 Focus previous | |
| 78 .BR window . | |
| 79 .TP | |
| 55 | 80 .B Mod1-Return |
| 238 | 81 Zoom current |
| 55 | 82 .B window |
| 83 to the | |
| 84 .B master | |
| 293 | 85 column |
| 86 .RB ( tiling | |
| 87 mode only). | |
| 55 | 88 .TP |
| 89 .B Mod1-m | |
| 90 Maximize current | |
|
288
b7865e6feef2
applied sanders man page patch, removed button2 from bar click
Anselm R.Garbe <arg@10ksloc.org>
parents:
270
diff
changeset
|
91 .BR window . |
| 55 | 92 .TP |
|
415
ad2b6ce6e95b
I really need column growing, now pushing upstream
Anselm R. Garbe <arg@10kloc.org>
parents:
398
diff
changeset
|
93 .B Mod1-g |
|
ad2b6ce6e95b
I really need column growing, now pushing upstream
Anselm R. Garbe <arg@10kloc.org>
parents:
398
diff
changeset
|
94 Grow current |
|
ad2b6ce6e95b
I really need column growing, now pushing upstream
Anselm R. Garbe <arg@10kloc.org>
parents:
398
diff
changeset
|
95 .BR column |
|
ad2b6ce6e95b
I really need column growing, now pushing upstream
Anselm R. Garbe <arg@10kloc.org>
parents:
398
diff
changeset
|
96 .RB ( tiling |
|
ad2b6ce6e95b
I really need column growing, now pushing upstream
Anselm R. Garbe <arg@10kloc.org>
parents:
398
diff
changeset
|
97 mode only). |
|
ad2b6ce6e95b
I really need column growing, now pushing upstream
Anselm R. Garbe <arg@10kloc.org>
parents:
398
diff
changeset
|
98 .TP |
|
421
ca2d99d8b8fc
well ok, added Mod-s to default bindings (however, I don't need it)
Anselm R. Garbe <arg@10kloc.org>
parents:
415
diff
changeset
|
99 .B Mod1-s |
|
ca2d99d8b8fc
well ok, added Mod-s to default bindings (however, I don't need it)
Anselm R. Garbe <arg@10kloc.org>
parents:
415
diff
changeset
|
100 Shrink current |
|
ca2d99d8b8fc
well ok, added Mod-s to default bindings (however, I don't need it)
Anselm R. Garbe <arg@10kloc.org>
parents:
415
diff
changeset
|
101 .BR column |
|
ca2d99d8b8fc
well ok, added Mod-s to default bindings (however, I don't need it)
Anselm R. Garbe <arg@10kloc.org>
parents:
415
diff
changeset
|
102 .RB ( tiling |
|
ca2d99d8b8fc
well ok, added Mod-s to default bindings (however, I don't need it)
Anselm R. Garbe <arg@10kloc.org>
parents:
415
diff
changeset
|
103 mode only). |
|
ca2d99d8b8fc
well ok, added Mod-s to default bindings (however, I don't need it)
Anselm R. Garbe <arg@10kloc.org>
parents:
415
diff
changeset
|
104 .TP |
|
396
be3be9590d5c
changed shortcut into Mod1-0
Anselm R. Garbe <arg@10kloc.org>
parents:
395
diff
changeset
|
105 .B Mod1-Shift-[1..n] |
| 293 | 106 Apply |
| 107 .B nth tag | |
| 108 to current | |
| 109 .BR window . | |
| 110 .TP | |
|
396
be3be9590d5c
changed shortcut into Mod1-0
Anselm R. Garbe <arg@10kloc.org>
parents:
395
diff
changeset
|
111 .B Mod1-Control-Shift-[1..n] |
| 293 | 112 Add/remove |
| 113 .B nth tag | |
| 114 to/from current | |
| 115 .BR window . | |
| 116 .TP | |
| 117 .B Mod1-Shift-c | |
| 118 Close focused | |
| 119 .B window. | |
| 55 | 120 .TP |
| 121 .B Mod1-space | |
| 143 | 122 Toggle between |
| 123 .B tiled | |
| 124 and | |
| 125 .B floating | |
| 126 mode (affects | |
|
219
d8e508716aa8
added a trailing '.' to shortcut descriptions in dwm(1)
arg@10ksloc.org
parents:
212
diff
changeset
|
127 .BR "all windows" ). |
| 56 | 128 .TP |
|
396
be3be9590d5c
changed shortcut into Mod1-0
Anselm R. Garbe <arg@10kloc.org>
parents:
395
diff
changeset
|
129 .B Mod1-[1..n] |
| 293 | 130 View all windows with |
| 131 .BR "tag n" . | |
| 56 | 132 .TP |
|
396
be3be9590d5c
changed shortcut into Mod1-0
Anselm R. Garbe <arg@10kloc.org>
parents:
395
diff
changeset
|
133 .B Mod1-0 |
|
395
7528080beb0e
added viewall to mainstream (only Ross Mohns version, not the toggle)
Anselm R. Garbe <arg@10kloc.org>
parents:
394
diff
changeset
|
134 View all windows with any |
|
7528080beb0e
added viewall to mainstream (only Ross Mohns version, not the toggle)
Anselm R. Garbe <arg@10kloc.org>
parents:
394
diff
changeset
|
135 .BR "tag" . |
|
7528080beb0e
added viewall to mainstream (only Ross Mohns version, not the toggle)
Anselm R. Garbe <arg@10kloc.org>
parents:
394
diff
changeset
|
136 .TP |
|
396
be3be9590d5c
changed shortcut into Mod1-0
Anselm R. Garbe <arg@10kloc.org>
parents:
395
diff
changeset
|
137 .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
|
138 Add/remove all windows with |
|
b7865e6feef2
applied sanders man page patch, removed button2 from bar click
Anselm R.Garbe <arg@10ksloc.org>
parents:
270
diff
changeset
|
139 .B tag n |
|
b7865e6feef2
applied sanders man page patch, removed button2 from bar click
Anselm R.Garbe <arg@10ksloc.org>
parents:
270
diff
changeset
|
140 to/from the view. |
|
264
afcea99a4f3f
updated man page, added CAVEATS section
Anselm R.Garbe <arg@10ksloc.org>
parents:
262
diff
changeset
|
141 .TP |
| 293 | 142 .B Mod1-Shift-q |
| 143 Quit | |
| 144 .B dwm. | |
| 256 | 145 .SS Mouse commands |
| 82 | 146 .TP |
|
59
5d4653de9a1c
implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents:
58
diff
changeset
|
147 .B Mod1-Button1 |
| 238 | 148 Move current |
|
59
5d4653de9a1c
implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents:
58
diff
changeset
|
149 .B window |
| 293 | 150 while dragging |
| 151 .RB ( floating | |
| 152 mode only). | |
|
59
5d4653de9a1c
implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents:
58
diff
changeset
|
153 .TP |
| 238 | 154 .B Mod1-Button2 |
| 155 Zoom current | |
| 156 .B window | |
| 157 to the | |
| 158 .B master | |
| 293 | 159 column |
| 160 .RB ( tiling | |
| 161 mode only). | |
| 238 | 162 .TP |
|
59
5d4653de9a1c
implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents:
58
diff
changeset
|
163 .B Mod1-Button3 |
| 238 | 164 Resize current |
|
59
5d4653de9a1c
implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents:
58
diff
changeset
|
165 .B window |
| 293 | 166 while dragging |
| 167 .RB ( floating | |
| 168 mode only). | |
| 82 | 169 .SH CUSTOMIZATION |
| 170 .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
|
171 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
|
172 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
|
173 .SH CAVEATS |
| 347 | 174 The status bar may display |
|
288
b7865e6feef2
applied sanders man page patch, removed button2 from bar click
Anselm R.Garbe <arg@10ksloc.org>
parents:
270
diff
changeset
|
175 .B broken pipe |
|
264
afcea99a4f3f
updated man page, added CAVEATS section
Anselm R.Garbe <arg@10ksloc.org>
parents:
262
diff
changeset
|
176 when |
|
afcea99a4f3f
updated man page, added CAVEATS section
Anselm R.Garbe <arg@10ksloc.org>
parents:
262
diff
changeset
|
177 .B dwm |
|
afcea99a4f3f
updated man page, added CAVEATS section
Anselm R.Garbe <arg@10ksloc.org>
parents:
262
diff
changeset
|
178 has been started by |
|
afcea99a4f3f
updated man page, added CAVEATS section
Anselm R.Garbe <arg@10ksloc.org>
parents:
262
diff
changeset
|
179 .BR xdm (1), |
|
afcea99a4f3f
updated man page, added CAVEATS section
Anselm R.Garbe <arg@10ksloc.org>
parents:
262
diff
changeset
|
180 because it closes standard output before executing |
|
288
b7865e6feef2
applied sanders man page patch, removed button2 from bar click
Anselm R.Garbe <arg@10ksloc.org>
parents:
270
diff
changeset
|
181 .BR dwm . |
| 201 | 182 .SH SEE ALSO |
| 183 .BR dmenu (1) |