Mercurial > aewl
annotate dwm.1 @ 277:1e7fa455e3b4
applied the saner patch (removed the pathetic one)
author | Anselm R.Garbe <arg@10ksloc.org> |
---|---|
date | Mon, 14 Aug 2006 15:33:23 +0200 |
parents | dacd3f3c5823 |
children | b7865e6feef2 |
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 |
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 |
270
dacd3f3c5823
implemented restack behavior (floats are on top in tiled mode)
Anselm R.Garbe <arg@10ksloc.org>
parents:
267
diff
changeset
|
39 .B Button[1,2] |
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
|
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 |
270
dacd3f3c5823
implemented restack behavior (floats are on top in tiled mode)
Anselm R.Garbe <arg@10ksloc.org>
parents:
267
diff
changeset
|
43 .B Button3 |
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) |