Mercurial > dwm-meillo
annotate dwm.1 @ 394:1da9a6b94ca9
implemented Button2 press on tags for toggletag on the focused client
author | Anselm R. Garbe <arg@10kloc.org> |
---|---|
date | Thu, 31 Aug 2006 17:49:04 +0200 |
parents | fc9d35252ab4 |
children | 7528080beb0e |
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 |
394
1da9a6b94ca9
implemented Button2 press on tags for toggletag on the focused client
Anselm R. Garbe <arg@10kloc.org>
parents:
371
diff
changeset
|
50 .B Button2 |
1da9a6b94ca9
implemented Button2 press on tags for toggletag on the focused client
Anselm R. Garbe <arg@10kloc.org>
parents:
371
diff
changeset
|
51 click on a tag label adds/removes that |
1da9a6b94ca9
implemented Button2 press on tags for toggletag on the focused client
Anselm R. Garbe <arg@10kloc.org>
parents:
371
diff
changeset
|
52 .B tag |
1da9a6b94ca9
implemented Button2 press on tags for toggletag on the focused client
Anselm R. Garbe <arg@10kloc.org>
parents:
371
diff
changeset
|
53 to/from the focused |
1da9a6b94ca9
implemented Button2 press on tags for toggletag on the focused client
Anselm R. Garbe <arg@10kloc.org>
parents:
371
diff
changeset
|
54 .B window. |
1da9a6b94ca9
implemented Button2 press on tags for toggletag on the focused client
Anselm R. Garbe <arg@10kloc.org>
parents:
371
diff
changeset
|
55 .TP |
270
dacd3f3c5823
implemented restack behavior (floats are on top in tiled mode)
Anselm R.Garbe <arg@10ksloc.org>
parents:
267
diff
changeset
|
56 .B Button3 |
288
b7865e6feef2
applied sanders man page patch, removed button2 from bar click
Anselm R.Garbe <arg@10ksloc.org>
parents:
270
diff
changeset
|
57 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
|
58 .B tag |
b7865e6feef2
applied sanders man page patch, removed button2 from bar click
Anselm R.Garbe <arg@10ksloc.org>
parents:
270
diff
changeset
|
59 to/from the view. |
256 | 60 .SS Keyboard commands |
55 | 61 .TP |
293 | 62 .B Mod1-Shift-Return |
63 Start | |
64 .BR xterm (1). | |
65 .TP | |
66 .B Mod1-Tab | |
67 Focus next | |
68 .BR window . | |
69 .TP | |
70 .B Mod1-Shift-Tab | |
71 Focus previous | |
72 .BR window . | |
73 .TP | |
55 | 74 .B Mod1-Return |
238 | 75 Zoom current |
55 | 76 .B window |
77 to the | |
78 .B master | |
293 | 79 column |
80 .RB ( tiling | |
81 mode only). | |
55 | 82 .TP |
83 .B Mod1-m | |
84 Maximize current | |
288
b7865e6feef2
applied sanders man page patch, removed button2 from bar click
Anselm R.Garbe <arg@10ksloc.org>
parents:
270
diff
changeset
|
85 .BR window . |
55 | 86 .TP |
293 | 87 .B Mod1-Shift-[0..n] |
88 Apply | |
89 .B nth tag | |
90 to current | |
91 .BR window . | |
92 .TP | |
93 .B Mod1-Control-Shift-[0..n] | |
94 Add/remove | |
95 .B nth tag | |
96 to/from current | |
97 .BR window . | |
98 .TP | |
99 .B Mod1-Shift-c | |
100 Close focused | |
101 .B window. | |
55 | 102 .TP |
103 .B Mod1-space | |
143 | 104 Toggle between |
105 .B tiled | |
106 and | |
107 .B floating | |
108 mode (affects | |
219
d8e508716aa8
added a trailing '.' to shortcut descriptions in dwm(1)
arg@10ksloc.org
parents:
212
diff
changeset
|
109 .BR "all windows" ). |
56 | 110 .TP |
293 | 111 .B Mod1-[0..n] |
112 View all windows with | |
113 .BR "tag n" . | |
56 | 114 .TP |
131
65efe27cbf3d
preparing 0.6 which will be available in the evening after sanders patch approx.
arg@10ksloc.org
parents:
123
diff
changeset
|
115 .B Mod1-Control-[0..n] |
288
b7865e6feef2
applied sanders man page patch, removed button2 from bar click
Anselm R.Garbe <arg@10ksloc.org>
parents:
270
diff
changeset
|
116 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
|
117 .B tag n |
b7865e6feef2
applied sanders man page patch, removed button2 from bar click
Anselm R.Garbe <arg@10ksloc.org>
parents:
270
diff
changeset
|
118 to/from the view. |
264
afcea99a4f3f
updated man page, added CAVEATS section
Anselm R.Garbe <arg@10ksloc.org>
parents:
262
diff
changeset
|
119 .TP |
293 | 120 .B Mod1-Shift-q |
121 Quit | |
122 .B dwm. | |
256 | 123 .SS Mouse commands |
82 | 124 .TP |
59
5d4653de9a1c
implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents:
58
diff
changeset
|
125 .B Mod1-Button1 |
238 | 126 Move current |
59
5d4653de9a1c
implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents:
58
diff
changeset
|
127 .B window |
293 | 128 while dragging |
129 .RB ( floating | |
130 mode only). | |
59
5d4653de9a1c
implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents:
58
diff
changeset
|
131 .TP |
238 | 132 .B Mod1-Button2 |
133 Zoom current | |
134 .B window | |
135 to the | |
136 .B master | |
293 | 137 column |
138 .RB ( tiling | |
139 mode only). | |
238 | 140 .TP |
59
5d4653de9a1c
implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents:
58
diff
changeset
|
141 .B Mod1-Button3 |
238 | 142 Resize current |
59
5d4653de9a1c
implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents:
58
diff
changeset
|
143 .B window |
293 | 144 while dragging |
145 .RB ( floating | |
146 mode only). | |
82 | 147 .SH CUSTOMIZATION |
148 .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
|
149 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
|
150 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
|
151 .SH CAVEATS |
347 | 152 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
|
153 .B broken pipe |
264
afcea99a4f3f
updated man page, added CAVEATS section
Anselm R.Garbe <arg@10ksloc.org>
parents:
262
diff
changeset
|
154 when |
afcea99a4f3f
updated man page, added CAVEATS section
Anselm R.Garbe <arg@10ksloc.org>
parents:
262
diff
changeset
|
155 .B dwm |
afcea99a4f3f
updated man page, added CAVEATS section
Anselm R.Garbe <arg@10ksloc.org>
parents:
262
diff
changeset
|
156 has been started by |
afcea99a4f3f
updated man page, added CAVEATS section
Anselm R.Garbe <arg@10ksloc.org>
parents:
262
diff
changeset
|
157 .BR xdm (1), |
afcea99a4f3f
updated man page, added CAVEATS section
Anselm R.Garbe <arg@10ksloc.org>
parents:
262
diff
changeset
|
158 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
|
159 .BR dwm . |
201 | 160 .SH SEE ALSO |
161 .BR dmenu (1) |