Mercurial > aewl

annotate dwm.1 @ 632:3afe7c74ceb9

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
added the java odyssee to CAVEATS section
author arg@mig29
date Wed, 13 Dec 2006 13:42:17 +0100
parents 0811e4114faa
children 7209e355762c
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
445
00584fe34361 made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents: 444
diff changeset
8 dwm is a dynamic window manager for X. It manages windows in tiling and
00584fe34361 made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents: 444
diff changeset
9 floating modes. Either mode can be applied dynamically, optimizing the
00584fe34361 made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents: 444
diff changeset
10 environment for 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
11 .P
504
0cefc169ff67 renamed column into area
Anselm R. Garbe <arg@10kloc.org>
parents: 483
diff changeset
12 In tiling mode windows are managed in a master and stacking area. The master
0cefc169ff67 renamed column into area
Anselm R. Garbe <arg@10kloc.org>
parents: 483
diff changeset
13 area contains the window which currently needs most attention, whereas the
0cefc169ff67 renamed column into area
Anselm R. Garbe <arg@10kloc.org>
parents: 483
diff changeset
14 stacking area contains all other windows. In floating mode windows can be
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
15 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
16 regardless of the mode selected.
79
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
17 .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
18 Windows are grouped by tags. Each window can be tagged with one or multiple
470
9d728cba93d6 fixed a nuance in dwm.1
arg@mmvi
parents: 449
diff changeset
19 tags. Selecting certain tags displays all windows with these tags.
79
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
20 .P
445
00584fe34361 made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents: 444
diff changeset
21 dwm contains a small status bar which displays all available tags, the mode,
00584fe34361 made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents: 444
diff changeset
22 the title of the focused window, and the text read from standard input. The
575
719b37b37b0d using the term 'indicated' instead of 'higlighted'
arg@mig29
parents: 574
diff changeset
23 selected tags are indicated with a different color. The tags of the focused
606
44b5617c78b3 and the winner is
arg@mig29
parents: 602
diff changeset
24 window are indicated with a filled square in the top left corner. The tags
625
0811e4114faa we don't use the term clients anymore, windows is the better term
arg@mig29
parents: 606
diff changeset
25 which are applied to one or more windows are indicated with an empty square in
606
44b5617c78b3 and the winner is
arg@mig29
parents: 602
diff changeset
26 the top left corner.
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
445
00584fe34361 made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents: 444
diff changeset
28 dwm draws a 1-pixel border around windows to indicate the focus state.
342
a1901753deef updated man page
Anselm R. Garbe <arg@10kloc.org>
parents: 341
diff changeset
29 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
30 .SH OPTIONS
0
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
31 .TP
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
32 .B \-v
80
8125f908c80c several additions in mouse handling ;)
Anselm R. Garbe <garbeam@wmii.de>
parents: 79
diff changeset
33 prints version information to standard output, then exits.
82
3954fc13b2e8 simplified man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 80
diff changeset
34 .SH USAGE
256
b37acb9ead8c updated dwm(1)
Anselm R.Garbe <arg@10ksloc.org>
parents: 238
diff changeset
35 .SS Status bar
b37acb9ead8c updated dwm(1)
Anselm R.Garbe <arg@10ksloc.org>
parents: 238
diff changeset
36 .TP
259
d661ecce0c75 applied Sanders fixes to dwm.1
Anselm R.Garbe <arg@10ksloc.org>
parents: 258
diff changeset
37 .B Standard input
d661ecce0c75 applied Sanders fixes to dwm.1
Anselm R.Garbe <arg@10ksloc.org>
parents: 258
diff changeset
38 is read and displayed in the status text area.
256
b37acb9ead8c updated dwm(1)
Anselm R.Garbe <arg@10ksloc.org>
parents: 238
diff changeset
39 .TP
288
b7865e6feef2 applied sanders man page patch, removed button2 from bar click
Anselm R.Garbe <arg@10ksloc.org>
parents: 270
diff changeset
40 .B Button1
449
78d36a1dd1d9 really small changes to dwm.1
Anselm R. Garbe <arg@10kloc.org>
parents: 445
diff changeset
41 click on a tag label to display all windows with that tag, click on the mode
525
7433954e80af final fix for man page
Anselm R. Garbe <arg@10kloc.org>
parents: 520
diff changeset
42 label toggles between tiling and floating 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
43 .TP
270
dacd3f3c5823 implemented restack behavior (floats are on top in tiled mode)
Anselm R.Garbe <arg@10ksloc.org>
parents: 267
diff changeset
44 .B Button3
530
451f19d48845 removed the stack position stuff
Anselm R. Garbe <arg@10kloc.org>
parents: 525
diff changeset
45 click on a tag label adds/removes all windows with that tag to/from the view.
398
9c703e528e58 applied sanders patch
Anselm R. Garbe <arg@10kloc.org>
parents: 396
diff changeset
46 .TP
9c703e528e58 applied sanders patch
Anselm R. Garbe <arg@10kloc.org>
parents: 396
diff changeset
47 .B Mod1-Button1
445
00584fe34361 made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents: 444
diff changeset
48 click on a tag label applies that tag to the focused window.
398
9c703e528e58 applied sanders patch
Anselm R. Garbe <arg@10kloc.org>
parents: 396
diff changeset
49 .TP
9c703e528e58 applied sanders patch
Anselm R. Garbe <arg@10kloc.org>
parents: 396
diff changeset
50 .B Mod1-Button3
445
00584fe34361 made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents: 444
diff changeset
51 click on a tag label adds/removes that tag to/from the focused window.
256
b37acb9ead8c updated dwm(1)
Anselm R.Garbe <arg@10ksloc.org>
parents: 238
diff changeset
52 .SS Keyboard commands
55
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
53 .TP
293
093744cc5353 applied jk_to_tab patch
Anselm R.Garbe <arg@10ksloc.org>
parents: 288
diff changeset
54 .B Mod1-Shift-Return
093744cc5353 applied jk_to_tab patch
Anselm R.Garbe <arg@10ksloc.org>
parents: 288
diff changeset
55 Start
093744cc5353 applied jk_to_tab patch
Anselm R.Garbe <arg@10ksloc.org>
parents: 288
diff changeset
56 .BR xterm (1).
093744cc5353 applied jk_to_tab patch
Anselm R.Garbe <arg@10ksloc.org>
parents: 288
diff changeset
57 .TP
093744cc5353 applied jk_to_tab patch
Anselm R.Garbe <arg@10ksloc.org>
parents: 288
diff changeset
58 .B Mod1-Tab
445
00584fe34361 made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents: 444
diff changeset
59 Focus next window.
293
093744cc5353 applied jk_to_tab patch
Anselm R.Garbe <arg@10ksloc.org>
parents: 288
diff changeset
60 .TP
093744cc5353 applied jk_to_tab patch
Anselm R.Garbe <arg@10ksloc.org>
parents: 288
diff changeset
61 .B Mod1-Shift-Tab
445
00584fe34361 made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents: 444
diff changeset
62 Focus previous window.
293
093744cc5353 applied jk_to_tab patch
Anselm R.Garbe <arg@10ksloc.org>
parents: 288
diff changeset
63 .TP
55
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
64 .B Mod1-Return
504
0cefc169ff67 renamed column into area
Anselm R. Garbe <arg@10kloc.org>
parents: 483
diff changeset
65 Zooms/cycles current window to/from master area (tiling mode), toggles maximization current window (floating mode).
477
bf3de99b7c0c small man page fix
arg@mmvi
parents: 474
diff changeset
66 .TP
415
ad2b6ce6e95b I really need column growing, now pushing upstream
Anselm R. Garbe <arg@10kloc.org>
parents: 398
diff changeset
67 .B Mod1-g
558
e249e2952a32 applied Gottox patch to simplify the resizing of col, instead of resizing the current area, it only resizes the master area in the future (seems more predictable)
arg@mig29
parents: 530
diff changeset
68 Grow master area (tiling mode only).
415
ad2b6ce6e95b I really need column growing, now pushing upstream
Anselm R. Garbe <arg@10kloc.org>
parents: 398
diff changeset
69 .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
70 .B Mod1-s
558
e249e2952a32 applied Gottox patch to simplify the resizing of col, instead of resizing the current area, it only resizes the master area in the future (seems more predictable)
arg@mig29
parents: 530
diff changeset
71 Shrink master area (tiling mode only).
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
72 .TP
396
be3be9590d5c changed shortcut into Mod1-0
Anselm R. Garbe <arg@10kloc.org>
parents: 395
diff changeset
73 .B Mod1-Shift-[1..n]
293
093744cc5353 applied jk_to_tab patch
Anselm R.Garbe <arg@10ksloc.org>
parents: 288
diff changeset
74 Apply
445
00584fe34361 made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents: 444
diff changeset
75 .RB nth
00584fe34361 made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents: 444
diff changeset
76 tag to current window.
293
093744cc5353 applied jk_to_tab patch
Anselm R.Garbe <arg@10ksloc.org>
parents: 288
diff changeset
77 .TP
594
f7dcd3ac8d6f removed viewall(), replaced with view(-1); added tag(-1) to tag a client with all tags (new key combo MODKEY-Shift-0)
arg@mig29
parents: 592
diff changeset
78 .B Mod1-Shift-0
f7dcd3ac8d6f removed viewall(), replaced with view(-1); added tag(-1) to tag a client with all tags (new key combo MODKEY-Shift-0)
arg@mig29
parents: 592
diff changeset
79 Apply all tags to current window.
f7dcd3ac8d6f removed viewall(), replaced with view(-1); added tag(-1) to tag a client with all tags (new key combo MODKEY-Shift-0)
arg@mig29
parents: 592
diff changeset
80 .TP
396
be3be9590d5c changed shortcut into Mod1-0
Anselm R. Garbe <arg@10kloc.org>
parents: 395
diff changeset
81 .B Mod1-Control-Shift-[1..n]
293
093744cc5353 applied jk_to_tab patch
Anselm R.Garbe <arg@10ksloc.org>
parents: 288
diff changeset
82 Add/remove
445
00584fe34361 made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents: 444
diff changeset
83 .B nth
00584fe34361 made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents: 444
diff changeset
84 tag to/from current window.
293
093744cc5353 applied jk_to_tab patch
Anselm R.Garbe <arg@10ksloc.org>
parents: 288
diff changeset
85 .TP
093744cc5353 applied jk_to_tab patch
Anselm R.Garbe <arg@10ksloc.org>
parents: 288
diff changeset
86 .B Mod1-Shift-c
445
00584fe34361 made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents: 444
diff changeset
87 Close focused window.
55
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
88 .TP
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
89 .B Mod1-space
525
7433954e80af final fix for man page
Anselm R. Garbe <arg@10kloc.org>
parents: 520
diff changeset
90 Toggle between tiling and floating mode (affects all windows).
56
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
91 .TP
585
83807f4d18e9 added man page entry
arg@mig29
parents: 578
diff changeset
92 .B Mod1-Shift-space
592
32b246925086 extended dwm.1 with last change
arg@mig29
parents: 585
diff changeset
93 Toggle focused window between floating and non-floating state (tiling mode only).
585
83807f4d18e9 added man page entry
arg@mig29
parents: 578
diff changeset
94 .TP
396
be3be9590d5c changed shortcut into Mod1-0
Anselm R. Garbe <arg@10kloc.org>
parents: 395
diff changeset
95 .B Mod1-[1..n]
293
093744cc5353 applied jk_to_tab patch
Anselm R.Garbe <arg@10ksloc.org>
parents: 288
diff changeset
96 View all windows with
445
00584fe34361 made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents: 444
diff changeset
97 .BR nth
00584fe34361 made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents: 444
diff changeset
98 tag.
56
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
99 .TP
396
be3be9590d5c changed shortcut into Mod1-0
Anselm R. Garbe <arg@10kloc.org>
parents: 395
diff changeset
100 .B Mod1-0
445
00584fe34361 made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents: 444
diff changeset
101 View all windows with any tag.
395
7528080beb0e added viewall to mainstream (only Ross Mohns version, not the toggle)
Anselm R. Garbe <arg@10kloc.org>
parents: 394
diff changeset
102 .TP
396
be3be9590d5c changed shortcut into Mod1-0
Anselm R. Garbe <arg@10kloc.org>
parents: 395
diff changeset
103 .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
104 Add/remove all windows with
445
00584fe34361 made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents: 444
diff changeset
105 .BR nth
00584fe34361 made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents: 444
diff changeset
106 tag to/from the view.
264
afcea99a4f3f updated man page, added CAVEATS section
Anselm R.Garbe <arg@10ksloc.org>
parents: 262
diff changeset
107 .TP
293
093744cc5353 applied jk_to_tab patch
Anselm R.Garbe <arg@10ksloc.org>
parents: 288
diff changeset
108 .B Mod1-Shift-q
445
00584fe34361 made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents: 444
diff changeset
109 Quit dwm.
256
b37acb9ead8c updated dwm(1)
Anselm R.Garbe <arg@10ksloc.org>
parents: 238
diff changeset
110 .SS Mouse commands
82
3954fc13b2e8 simplified man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 80
diff changeset
111 .TP
59
5d4653de9a1c implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents: 58
diff changeset
112 .B Mod1-Button1
445
00584fe34361 made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents: 444
diff changeset
113 Move current window while dragging (floating mode only).
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
504
0cefc169ff67 renamed column into area
Anselm R. Garbe <arg@10kloc.org>
parents: 483
diff changeset
116 Zoom current window to the master area (tiling mode only).
238
969fb6be25e1 applied sander's patch
Anselm R.Garbe <arg@10ksloc.org>
parents: 232
diff changeset
117 .TP
59
5d4653de9a1c implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents: 58
diff changeset
118 .B Mod1-Button3
445
00584fe34361 made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents: 444
diff changeset
119 Resize current window while dragging (floating mode only).
82
3954fc13b2e8 simplified man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 80
diff changeset
120 .SH CUSTOMIZATION
445
00584fe34361 made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents: 444
diff changeset
121 dwm is customized by creating a custom config.h and (re)compiling the source
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
122 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
123 .SH CAVEATS
347
e438c8ba86f6 yet another fix
Anselm R. Garbe <arg@10kloc.org>
parents: 346
diff changeset
124 The status bar may display
445
00584fe34361 made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents: 444
diff changeset
125 .BR "broken pipe"
632
3afe7c74ceb9 added the java odyssee to CAVEATS section
arg@mig29
parents: 625
diff changeset
126 when dwm has been started by an X session manager like
264
afcea99a4f3f updated man page, added CAVEATS section
Anselm R.Garbe <arg@10ksloc.org>
parents: 262
diff changeset
127 .BR xdm (1),
632
3afe7c74ceb9 added the java odyssee to CAVEATS section
arg@mig29
parents: 625
diff changeset
128 because those close standard output before executing dwm.
3afe7c74ceb9 added the java odyssee to CAVEATS section
arg@mig29
parents: 625
diff changeset
129 .P
3afe7c74ceb9 added the java odyssee to CAVEATS section
arg@mig29
parents: 625
diff changeset
130 Java applications which use the XToolkit/XAWT backend may draw grey windows
3afe7c74ceb9 added the java odyssee to CAVEATS section
arg@mig29
parents: 625
diff changeset
131 only. The XToolkit/XAWT backend breaks ICCCM-compliance in recent JDK 1.5 and early
3afe7c74ceb9 added the java odyssee to CAVEATS section
arg@mig29
parents: 625
diff changeset
132 JDK 1.6 versions, because it assumes a reparenting window manager. As workaround
3afe7c74ceb9 added the java odyssee to CAVEATS section
arg@mig29
parents: 625
diff changeset
133 wether you use JDK 1.4 (which don't contains the XToolkit/XAWT backend) or you
3afe7c74ceb9 added the java odyssee to CAVEATS section
arg@mig29
parents: 625
diff changeset
134 define the following environment variable accordingly (to use the older Motif
3afe7c74ceb9 added the java odyssee to CAVEATS section
arg@mig29
parents: 625
diff changeset
135 backend instead):
3afe7c74ceb9 added the java odyssee to CAVEATS section
arg@mig29
parents: 625
diff changeset
136 .BR AWT_TOOLKIT=MToolkit .
201
124671c251ee updated man page
arg@10ksloc.org
parents: 174
diff changeset
137 .SH SEE ALSO
124671c251ee updated man page
arg@10ksloc.org
parents: 174
diff changeset
138 .BR dmenu (1)