annotate dwm.1 @ 263:118d3e010e5e

made shortcuts like proposed by Sander, renamed viewextend to toggleview (more clear)
author Anselm R.Garbe <arg@10ksloc.org>
date Sun, 13 Aug 2006 17:58:06 +0200
parents d659a2dce2b5
children afcea99a4f3f
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
212
5b13a18800de applied Sanders man page/Makefile patch
arg@10ksloc.org
parents: 201
diff changeset
1 .TH DWM 1 dwm-VERSION
0
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
2 .SH NAME
39
0932ed0753dc another change
Anselm R. Garbe <garbeam@wmii.de>
parents: 38
diff changeset
3 dwm \- dynamic window manager
0
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
4 .SH SYNOPSIS
38
678730a1339b updated man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 34
diff changeset
5 .B dwm
0
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
6 .RB [ \-v ]
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
7 .SH DESCRIPTION
38
678730a1339b updated man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 34
diff changeset
8 .B dwm
82
3954fc13b2e8 simplified man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 80
diff changeset
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
3954fc13b2e8 simplified man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 80
diff changeset
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
ca809fdd30ea slight change to dwm.1
Anselm R. Garbe <garbeam@wmii.de>
parents: 82
diff changeset
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
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
30 .TP
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
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
3954fc13b2e8 simplified man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 80
diff changeset
33 .SH USAGE
256
b37acb9ead8c updated dwm(1)
Anselm R.Garbe <arg@10ksloc.org>
parents: 238
diff changeset
34 .SS Status bar
b37acb9ead8c updated dwm(1)
Anselm R.Garbe <arg@10ksloc.org>
parents: 238
diff changeset
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
b37acb9ead8c updated dwm(1)
Anselm R.Garbe <arg@10ksloc.org>
parents: 238
diff changeset
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
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
44 click on a tag label (un)extends the current
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
b37acb9ead8c updated dwm(1)
Anselm R.Garbe <arg@10ksloc.org>
parents: 238
diff changeset
46 .TP
b37acb9ead8c updated dwm(1)
Anselm R.Garbe <arg@10ksloc.org>
parents: 238
diff changeset
47 .B Button[1,4]
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
48 click on the bar focuses the previous
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 .B tag.
256
b37acb9ead8c updated dwm(1)
Anselm R.Garbe <arg@10ksloc.org>
parents: 238
diff changeset
50 .TP
b37acb9ead8c updated dwm(1)
Anselm R.Garbe <arg@10ksloc.org>
parents: 238
diff changeset
51 .B Button[2,5]
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
52 click on the bar focuses the next
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
53 .B tag.
256
b37acb9ead8c updated dwm(1)
Anselm R.Garbe <arg@10ksloc.org>
parents: 238
diff changeset
54 .SS Keyboard commands
55
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
55 .TP
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
56 .B Mod1-Return
238
969fb6be25e1 applied sander's patch
Anselm R.Garbe <arg@10ksloc.org>
parents: 232
diff changeset
57 Zoom current
55
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
58 .B window
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
59 to the
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
60 .B master
219
d8e508716aa8 added a trailing '.' to shortcut descriptions in dwm(1)
arg@10ksloc.org
parents: 212
diff changeset
61 column.
55
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
62 .TP
160
c8db0a825775 applied Sanders patches (numlock2)
arg@10ksloc.org
parents: 151
diff changeset
63 .B Mod1-h
c8db0a825775 applied Sanders patches (numlock2)
arg@10ksloc.org
parents: 151
diff changeset
64 Focus previous
219
d8e508716aa8 added a trailing '.' to shortcut descriptions in dwm(1)
arg@10ksloc.org
parents: 212
diff changeset
65 .B tag.
160
c8db0a825775 applied Sanders patches (numlock2)
arg@10ksloc.org
parents: 151
diff changeset
66 .TP
c8db0a825775 applied Sanders patches (numlock2)
arg@10ksloc.org
parents: 151
diff changeset
67 .B Mod1-j
c8db0a825775 applied Sanders patches (numlock2)
arg@10ksloc.org
parents: 151
diff changeset
68 Focus next
219
d8e508716aa8 added a trailing '.' to shortcut descriptions in dwm(1)
arg@10ksloc.org
parents: 212
diff changeset
69 .B window.
160
c8db0a825775 applied Sanders patches (numlock2)
arg@10ksloc.org
parents: 151
diff changeset
70 .TP
55
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
71 .B Mod1-k
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
72 Focus previous
219
d8e508716aa8 added a trailing '.' to shortcut descriptions in dwm(1)
arg@10ksloc.org
parents: 212
diff changeset
73 .B window.
55
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
74 .TP
160
c8db0a825775 applied Sanders patches (numlock2)
arg@10ksloc.org
parents: 151
diff changeset
75 .B Mod1-l
55
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
76 Focus next
219
d8e508716aa8 added a trailing '.' to shortcut descriptions in dwm(1)
arg@10ksloc.org
parents: 212
diff changeset
77 .B tag.
55
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
78 .TP
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
79 .B Mod1-m
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
80 Maximize current
219
d8e508716aa8 added a trailing '.' to shortcut descriptions in dwm(1)
arg@10ksloc.org
parents: 212
diff changeset
81 .B window.
55
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
82 .TP
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
83 .B Mod1-[0..n]
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
84 Focus
219
d8e508716aa8 added a trailing '.' to shortcut descriptions in dwm(1)
arg@10ksloc.org
parents: 212
diff changeset
85 .B nth tag.
55
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
86 .TP
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
87 .B Mod1-space
143
36cabfe408cd applied Sanders patches
arg@10ksloc.org
parents: 134
diff changeset
88 Toggle between
36cabfe408cd applied Sanders patches
arg@10ksloc.org
parents: 134
diff changeset
89 .B tiled
36cabfe408cd applied Sanders patches
arg@10ksloc.org
parents: 134
diff changeset
90 and
36cabfe408cd applied Sanders patches
arg@10ksloc.org
parents: 134
diff changeset
91 .B floating
36cabfe408cd applied Sanders patches
arg@10ksloc.org
parents: 134
diff changeset
92 mode (affects
219
d8e508716aa8 added a trailing '.' to shortcut descriptions in dwm(1)
arg@10ksloc.org
parents: 212
diff changeset
93 .BR "all windows" ).
56
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
94 .TP
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
95 .B Mod1-Shift-[0..n]
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
96 Apply
160
c8db0a825775 applied Sanders patches (numlock2)
arg@10ksloc.org
parents: 151
diff changeset
97 .B nth tag
c8db0a825775 applied Sanders patches (numlock2)
arg@10ksloc.org
parents: 151
diff changeset
98 to current
219
d8e508716aa8 added a trailing '.' to shortcut descriptions in dwm(1)
arg@10ksloc.org
parents: 212
diff changeset
99 .B window.
56
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
100 .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
101 .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
102 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
103 .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
104 .TP
56
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
105 .B Mod1-Shift-q
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
106 Quit
219
d8e508716aa8 added a trailing '.' to shortcut descriptions in dwm(1)
arg@10ksloc.org
parents: 212
diff changeset
107 .B dwm.
56
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
108 .TP
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
109 .B Mod1-Shift-Return
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
110 Start
219
d8e508716aa8 added a trailing '.' to shortcut descriptions in dwm(1)
arg@10ksloc.org
parents: 212
diff changeset
111 .B terminal.
56
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
112 .TP
131
65efe27cbf3d preparing 0.6 which will be available in the evening after sanders patch approx.
arg@10ksloc.org
parents: 123
diff changeset
113 .B Mod1-Control-[0..n]
56
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
114 Append
160
c8db0a825775 applied Sanders patches (numlock2)
arg@10ksloc.org
parents: 151
diff changeset
115 .B nth tag
c8db0a825775 applied Sanders patches (numlock2)
arg@10ksloc.org
parents: 151
diff changeset
116 to current
219
d8e508716aa8 added a trailing '.' to shortcut descriptions in dwm(1)
arg@10ksloc.org
parents: 212
diff changeset
117 .B window.
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
118 .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
119 .B Mod1-Control-Shift-[0..n]
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
120 (Un)extends
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
121 .B nth 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
122 with current
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
123 .B tag.
256
b37acb9ead8c updated dwm(1)
Anselm R.Garbe <arg@10ksloc.org>
parents: 238
diff changeset
124 .SS Mouse commands
82
3954fc13b2e8 simplified man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 80
diff changeset
125 .TP
59
5d4653de9a1c implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents: 58
diff changeset
126 .B Mod1-Button1
238
969fb6be25e1 applied sander's patch
Anselm R.Garbe <arg@10ksloc.org>
parents: 232
diff changeset
127 Move current
59
5d4653de9a1c implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents: 58
diff changeset
128 .B window
219
d8e508716aa8 added a trailing '.' to shortcut descriptions in dwm(1)
arg@10ksloc.org
parents: 212
diff changeset
129 while dragging.
59
5d4653de9a1c implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents: 58
diff changeset
130 .TP
238
969fb6be25e1 applied sander's patch
Anselm R.Garbe <arg@10ksloc.org>
parents: 232
diff changeset
131 .B Mod1-Button2
969fb6be25e1 applied sander's patch
Anselm R.Garbe <arg@10ksloc.org>
parents: 232
diff changeset
132 Zoom current
969fb6be25e1 applied sander's patch
Anselm R.Garbe <arg@10ksloc.org>
parents: 232
diff changeset
133 .B window
969fb6be25e1 applied sander's patch
Anselm R.Garbe <arg@10ksloc.org>
parents: 232
diff changeset
134 to the
969fb6be25e1 applied sander's patch
Anselm R.Garbe <arg@10ksloc.org>
parents: 232
diff changeset
135 .B master
969fb6be25e1 applied sander's patch
Anselm R.Garbe <arg@10ksloc.org>
parents: 232
diff changeset
136 column.
969fb6be25e1 applied sander's patch
Anselm R.Garbe <arg@10ksloc.org>
parents: 232
diff changeset
137 .TP
59
5d4653de9a1c implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents: 58
diff changeset
138 .B Mod1-Button3
238
969fb6be25e1 applied sander's patch
Anselm R.Garbe <arg@10ksloc.org>
parents: 232
diff changeset
139 Resize current
59
5d4653de9a1c implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents: 58
diff changeset
140 .B window
219
d8e508716aa8 added a trailing '.' to shortcut descriptions in dwm(1)
arg@10ksloc.org
parents: 212
diff changeset
141 while dragging.
82
3954fc13b2e8 simplified man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 80
diff changeset
142 .SH CUSTOMIZATION
3954fc13b2e8 simplified man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 80
diff changeset
143 .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
144 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
145 code. This keeps it fast, secure and simple.
201
124671c251ee updated man page
arg@10ksloc.org
parents: 174
diff changeset
146 .SH SEE ALSO
124671c251ee updated man page
arg@10ksloc.org
parents: 174
diff changeset
147 .BR dmenu (1)