Mercurial > dwm-meillo

annotate dwm.1 @ 292:4aa632b6ba66

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
changed main event loop
author Anselm R.Garbe <arg@10ksloc.org>
date Tue, 15 Aug 2006 07:31:42 +0200
parents b7865e6feef2
children 093744cc5353
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
288
b7865e6feef2 applied sanders man page patch, removed button2 from bar click
Anselm R.Garbe <arg@10ksloc.org>
parents: 270
diff changeset
39 .B Button1
b7865e6feef2 applied sanders man page patch, removed button2 from bar click
Anselm R.Garbe <arg@10ksloc.org>
parents: 270
diff changeset
40 click on a tag label views 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
41 .BR tag .
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
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
288
b7865e6feef2 applied sanders man page patch, removed button2 from bar click
Anselm R.Garbe <arg@10ksloc.org>
parents: 270
diff changeset
44 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
45 .B tag
b7865e6feef2 applied sanders man page patch, removed button2 from bar click
Anselm R.Garbe <arg@10ksloc.org>
parents: 270
diff changeset
46 to/from the view.
256
b37acb9ead8c updated dwm(1)
Anselm R.Garbe <arg@10ksloc.org>
parents: 238
diff changeset
47 .SS Keyboard commands
55
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
48 .TP
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
49 .B Mod1-Return
238
969fb6be25e1 applied sander's patch
Anselm R.Garbe <arg@10ksloc.org>
parents: 232
diff changeset
50 Zoom current
55
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
51 .B window
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
52 to the
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
53 .B master
219
d8e508716aa8 added a trailing '.' to shortcut descriptions in dwm(1)
arg@10ksloc.org
parents: 212
diff changeset
54 column.
55
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
55 .TP
160
c8db0a825775 applied Sanders patches (numlock2)
arg@10ksloc.org
parents: 151
diff changeset
56 .B Mod1-j
c8db0a825775 applied Sanders patches (numlock2)
arg@10ksloc.org
parents: 151
diff changeset
57 Focus next
288
b7865e6feef2 applied sanders man page patch, removed button2 from bar click
Anselm R.Garbe <arg@10ksloc.org>
parents: 270
diff changeset
58 .BR window .
160
c8db0a825775 applied Sanders patches (numlock2)
arg@10ksloc.org
parents: 151
diff changeset
59 .TP
55
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
60 .B Mod1-k
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
61 Focus previous
288
b7865e6feef2 applied sanders man page patch, removed button2 from bar click
Anselm R.Garbe <arg@10ksloc.org>
parents: 270
diff changeset
62 .BR window .
55
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
63 .TP
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
64 .B Mod1-m
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
65 Maximize current
288
b7865e6feef2 applied sanders man page patch, removed button2 from bar click
Anselm R.Garbe <arg@10ksloc.org>
parents: 270
diff changeset
66 .BR window .
55
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
67 .TP
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
68 .B Mod1-[0..n]
288
b7865e6feef2 applied sanders man page patch, removed button2 from bar click
Anselm R.Garbe <arg@10ksloc.org>
parents: 270
diff changeset
69 View all windows with
b7865e6feef2 applied sanders man page patch, removed button2 from bar click
Anselm R.Garbe <arg@10ksloc.org>
parents: 270
diff changeset
70 .BR "tag n" .
55
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
71 .TP
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
72 .B Mod1-space
143
36cabfe408cd applied Sanders patches
arg@10ksloc.org
parents: 134
diff changeset
73 Toggle between
36cabfe408cd applied Sanders patches
arg@10ksloc.org
parents: 134
diff changeset
74 .B tiled
36cabfe408cd applied Sanders patches
arg@10ksloc.org
parents: 134
diff changeset
75 and
36cabfe408cd applied Sanders patches
arg@10ksloc.org
parents: 134
diff changeset
76 .B floating
36cabfe408cd applied Sanders patches
arg@10ksloc.org
parents: 134
diff changeset
77 mode (affects
219
d8e508716aa8 added a trailing '.' to shortcut descriptions in dwm(1)
arg@10ksloc.org
parents: 212
diff changeset
78 .BR "all windows" ).
56
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
79 .TP
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
80 .B Mod1-Shift-[0..n]
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
81 Apply
160
c8db0a825775 applied Sanders patches (numlock2)
arg@10ksloc.org
parents: 151
diff changeset
82 .B nth tag
c8db0a825775 applied Sanders patches (numlock2)
arg@10ksloc.org
parents: 151
diff changeset
83 to current
288
b7865e6feef2 applied sanders man page patch, removed button2 from bar click
Anselm R.Garbe <arg@10ksloc.org>
parents: 270
diff changeset
84 .BR window .
56
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
85 .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
86 .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
87 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
88 .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
89 .TP
56
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
90 .B Mod1-Shift-q
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
91 Quit
219
d8e508716aa8 added a trailing '.' to shortcut descriptions in dwm(1)
arg@10ksloc.org
parents: 212
diff changeset
92 .B dwm.
56
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
93 .TP
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
94 .B Mod1-Shift-Return
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
95 Start
288
b7865e6feef2 applied sanders man page patch, removed button2 from bar click
Anselm R.Garbe <arg@10ksloc.org>
parents: 270
diff changeset
96 .BR terminal .
56
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
97 .TP
131
65efe27cbf3d preparing 0.6 which will be available in the evening after sanders patch approx.
arg@10ksloc.org
parents: 123
diff changeset
98 .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
99 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
100 .B tag n
b7865e6feef2 applied sanders man page patch, removed button2 from bar click
Anselm R.Garbe <arg@10ksloc.org>
parents: 270
diff changeset
101 to/from the view.
264
afcea99a4f3f updated man page, added CAVEATS section
Anselm R.Garbe <arg@10ksloc.org>
parents: 262
diff changeset
102 .TP
afcea99a4f3f updated man page, added CAVEATS section
Anselm R.Garbe <arg@10ksloc.org>
parents: 262
diff changeset
103 .B Mod1-Control-Shift-[0..n]
288
b7865e6feef2 applied sanders man page patch, removed button2 from bar click
Anselm R.Garbe <arg@10ksloc.org>
parents: 270
diff changeset
104 Add/remove
160
c8db0a825775 applied Sanders patches (numlock2)
arg@10ksloc.org
parents: 151
diff changeset
105 .B nth tag
288
b7865e6feef2 applied sanders man page patch, removed button2 from bar click
Anselm R.Garbe <arg@10ksloc.org>
parents: 270
diff changeset
106 to/from current
b7865e6feef2 applied sanders man page patch, removed button2 from bar click
Anselm R.Garbe <arg@10ksloc.org>
parents: 270
diff changeset
107 .BR window .
256
b37acb9ead8c updated dwm(1)
Anselm R.Garbe <arg@10ksloc.org>
parents: 238
diff changeset
108 .SS Mouse commands
82
3954fc13b2e8 simplified man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 80
diff changeset
109 .TP
59
5d4653de9a1c implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents: 58
diff changeset
110 .B Mod1-Button1
238
969fb6be25e1 applied sander's patch
Anselm R.Garbe <arg@10ksloc.org>
parents: 232
diff changeset
111 Move current
59
5d4653de9a1c implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents: 58
diff changeset
112 .B window
219
d8e508716aa8 added a trailing '.' to shortcut descriptions in dwm(1)
arg@10ksloc.org
parents: 212
diff changeset
113 while dragging.
59
5d4653de9a1c implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents: 58
diff changeset
114 .TP
238
969fb6be25e1 applied sander's patch
Anselm R.Garbe <arg@10ksloc.org>
parents: 232
diff changeset
115 .B Mod1-Button2
969fb6be25e1 applied sander's patch
Anselm R.Garbe <arg@10ksloc.org>
parents: 232
diff changeset
116 Zoom current
969fb6be25e1 applied sander's patch
Anselm R.Garbe <arg@10ksloc.org>
parents: 232
diff changeset
117 .B window
969fb6be25e1 applied sander's patch
Anselm R.Garbe <arg@10ksloc.org>
parents: 232
diff changeset
118 to the
969fb6be25e1 applied sander's patch
Anselm R.Garbe <arg@10ksloc.org>
parents: 232
diff changeset
119 .B master
969fb6be25e1 applied sander's patch
Anselm R.Garbe <arg@10ksloc.org>
parents: 232
diff changeset
120 column.
969fb6be25e1 applied sander's patch
Anselm R.Garbe <arg@10ksloc.org>
parents: 232
diff changeset
121 .TP
59
5d4653de9a1c implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents: 58
diff changeset
122 .B Mod1-Button3
238
969fb6be25e1 applied sander's patch
Anselm R.Garbe <arg@10ksloc.org>
parents: 232
diff changeset
123 Resize current
59
5d4653de9a1c implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents: 58
diff changeset
124 .B window
219
d8e508716aa8 added a trailing '.' to shortcut descriptions in dwm(1)
arg@10ksloc.org
parents: 212
diff changeset
125 while dragging.
82
3954fc13b2e8 simplified man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 80
diff changeset
126 .SH CUSTOMIZATION
3954fc13b2e8 simplified man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 80
diff changeset
127 .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
128 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
129 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
130 .SH CAVEATS
afcea99a4f3f updated man page, added CAVEATS section
Anselm R.Garbe <arg@10ksloc.org>
parents: 262
diff changeset
131 The status bar displays
288
b7865e6feef2 applied sanders man page patch, removed button2 from bar click
Anselm R.Garbe <arg@10ksloc.org>
parents: 270
diff changeset
132 .B broken pipe
264
afcea99a4f3f updated man page, added CAVEATS section
Anselm R.Garbe <arg@10ksloc.org>
parents: 262
diff changeset
133 when
afcea99a4f3f updated man page, added CAVEATS section
Anselm R.Garbe <arg@10ksloc.org>
parents: 262
diff changeset
134 .B dwm
afcea99a4f3f updated man page, added CAVEATS section
Anselm R.Garbe <arg@10ksloc.org>
parents: 262
diff changeset
135 has been started by
afcea99a4f3f updated man page, added CAVEATS section
Anselm R.Garbe <arg@10ksloc.org>
parents: 262
diff changeset
136 .BR xdm (1),
afcea99a4f3f updated man page, added CAVEATS section
Anselm R.Garbe <arg@10ksloc.org>
parents: 262
diff changeset
137 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
138 .BR dwm .
201
124671c251ee updated man page
arg@10ksloc.org
parents: 174
diff changeset
139 .SH SEE ALSO
124671c251ee updated man page
arg@10ksloc.org
parents: 174
diff changeset
140 .BR dmenu (1)