Mercurial > dwm-meillo
annotate dwm.1 @ 741:7c5d5b1e49c9
fixed copyright notice in Makefile
author | Anselm R. Garbe <arg@suckless.org> |
---|---|
date | Thu, 08 Feb 2007 14:09:52 +0100 |
parents | 583c0adeee79 |
children |
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 | |
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 | 12 In tiling mode windows are managed in a master and stacking area. The master |
657
ce3538c5c0d9
removed the term clients from dwm.1
Anselm R. Garbe <arg@suckless.org>
parents:
655
diff
changeset
|
13 area contains the windows which currently need most attention, whereas the |
504 | 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, |
667 | 16 regardless of the mode applied. |
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 | 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 | 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 | 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 |
700
f05c825db96b
moved BORDERPX to config.*.h
Anselm R. Garbe <arg@suckless.org>
parents:
687
diff
changeset
|
28 dwm draws a small border around windows to indicate the focus state. |
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 |
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 |
449
78d36a1dd1d9
really small changes to dwm.1
Anselm R. Garbe <arg@10kloc.org>
parents:
445
diff
changeset
|
40 click on a tag label to display all windows with that tag, click on the mode |
525 | 41 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
|
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 |
530
451f19d48845
removed the stack position stuff
Anselm R. Garbe <arg@10kloc.org>
parents:
525
diff
changeset
|
44 click on a tag label adds/removes all windows with that tag to/from the view. |
398 | 45 .TP |
677
a1cabd6c6f9f
added Button{4,5} description to dwm.1
Anselm R. Garbe <arg@suckless.org>
parents:
668
diff
changeset
|
46 .B Button4 |
a1cabd6c6f9f
added Button{4,5} description to dwm.1
Anselm R. Garbe <arg@suckless.org>
parents:
668
diff
changeset
|
47 click on the mode label increases the number of windows in the master area (tiling mode only). |
a1cabd6c6f9f
added Button{4,5} description to dwm.1
Anselm R. Garbe <arg@suckless.org>
parents:
668
diff
changeset
|
48 .TP |
a1cabd6c6f9f
added Button{4,5} description to dwm.1
Anselm R. Garbe <arg@suckless.org>
parents:
668
diff
changeset
|
49 .B Button5 |
a1cabd6c6f9f
added Button{4,5} description to dwm.1
Anselm R. Garbe <arg@suckless.org>
parents:
668
diff
changeset
|
50 click on the mode label decreases the number of windows in the master area (tiling mode only). |
a1cabd6c6f9f
added Button{4,5} description to dwm.1
Anselm R. Garbe <arg@suckless.org>
parents:
668
diff
changeset
|
51 .TP |
398 | 52 .B Mod1-Button1 |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
53 click on a tag label applies that tag to the focused window. |
398 | 54 .TP |
55 .B Mod1-Button3 | |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
56 click on a tag label adds/removes that tag to/from the focused window. |
256 | 57 .SS Keyboard commands |
55 | 58 .TP |
293 | 59 .B Mod1-Shift-Return |
60 Start | |
61 .BR xterm (1). | |
62 .TP | |
63 .B Mod1-Tab | |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
64 Focus next window. |
293 | 65 .TP |
66 .B Mod1-Shift-Tab | |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
67 Focus previous window. |
293 | 68 .TP |
55 | 69 .B Mod1-Return |
504 | 70 Zooms/cycles current window to/from master area (tiling mode), toggles maximization current window (floating mode). |
477 | 71 .TP |
415
ad2b6ce6e95b
I really need column growing, now pushing upstream
Anselm R. Garbe <arg@10kloc.org>
parents:
398
diff
changeset
|
72 .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
|
73 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
|
74 .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
|
75 .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
|
76 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
|
77 .TP |
655
4cf9ab28b36c
changed shortcuts to M-i and M-d
Anselm R. Garbe <arg@suckless.org>
parents:
653
diff
changeset
|
78 .B Mod1-i |
668
93ebb497c60d
small grammar fix of dwm.1
Anselm R. Garbe <arg@suckless.org>
parents:
667
diff
changeset
|
79 Increase the number of windows in the master area (tiling mode only). |
651
b9f4efd21473
added MODKEY-{plus,minus} shortcuts (increasing/decreasing master clients)
Anselm R. Garbe <arg@suckless.org>
parents:
634
diff
changeset
|
80 .TP |
655
4cf9ab28b36c
changed shortcuts to M-i and M-d
Anselm R. Garbe <arg@suckless.org>
parents:
653
diff
changeset
|
81 .B Mod1-d |
668
93ebb497c60d
small grammar fix of dwm.1
Anselm R. Garbe <arg@suckless.org>
parents:
667
diff
changeset
|
82 Decrease the number of windows in the master area (tiling mode only). |
651
b9f4efd21473
added MODKEY-{plus,minus} shortcuts (increasing/decreasing master clients)
Anselm R. Garbe <arg@suckless.org>
parents:
634
diff
changeset
|
83 .TP |
396
be3be9590d5c
changed shortcut into Mod1-0
Anselm R. Garbe <arg@10kloc.org>
parents:
395
diff
changeset
|
84 .B Mod1-Shift-[1..n] |
293 | 85 Apply |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
86 .RB nth |
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
87 tag to current window. |
293 | 88 .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
|
89 .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
|
90 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
|
91 .TP |
396
be3be9590d5c
changed shortcut into Mod1-0
Anselm R. Garbe <arg@10kloc.org>
parents:
395
diff
changeset
|
92 .B Mod1-Control-Shift-[1..n] |
293 | 93 Add/remove |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
94 .B nth |
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
95 tag to/from current window. |
293 | 96 .TP |
97 .B Mod1-Shift-c | |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
98 Close focused window. |
55 | 99 .TP |
100 .B Mod1-space | |
525 | 101 Toggle between tiling and floating mode (affects all windows). |
56 | 102 .TP |
585 | 103 .B Mod1-Shift-space |
592 | 104 Toggle focused window between floating and non-floating state (tiling mode only). |
585 | 105 .TP |
396
be3be9590d5c
changed shortcut into Mod1-0
Anselm R. Garbe <arg@10kloc.org>
parents:
395
diff
changeset
|
106 .B Mod1-[1..n] |
293 | 107 View all windows with |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
108 .BR nth |
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
109 tag. |
56 | 110 .TP |
396
be3be9590d5c
changed shortcut into Mod1-0
Anselm R. Garbe <arg@10kloc.org>
parents:
395
diff
changeset
|
111 .B Mod1-0 |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
112 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
|
113 .TP |
396
be3be9590d5c
changed shortcut into Mod1-0
Anselm R. Garbe <arg@10kloc.org>
parents:
395
diff
changeset
|
114 .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
|
115 Add/remove all windows with |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
116 .BR nth |
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
117 tag to/from the view. |
264
afcea99a4f3f
updated man page, added CAVEATS section
Anselm R.Garbe <arg@10ksloc.org>
parents:
262
diff
changeset
|
118 .TP |
293 | 119 .B Mod1-Shift-q |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
120 Quit dwm. |
256 | 121 .SS Mouse commands |
82 | 122 .TP |
59
5d4653de9a1c
implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents:
58
diff
changeset
|
123 .B Mod1-Button1 |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
124 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
|
125 .TP |
238 | 126 .B Mod1-Button2 |
504 | 127 Zoom current window to the master area (tiling mode only). |
238 | 128 .TP |
59
5d4653de9a1c
implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents:
58
diff
changeset
|
129 .B Mod1-Button3 |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
130 Resize current window while dragging (floating mode only). |
82 | 131 .SH CUSTOMIZATION |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
132 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
|
133 code. This keeps it fast, secure and simple. |
724
583c0adeee79
regarding to http://plan9.bell-labs.com/sources/contrib/rsc/man.ps the BUGS section should appear after SEE ALSO section.
Anselm R. Garbe <arg@suckless.org>
parents:
723
diff
changeset
|
134 .SH SEE ALSO |
583c0adeee79
regarding to http://plan9.bell-labs.com/sources/contrib/rsc/man.ps the BUGS section should appear after SEE ALSO section.
Anselm R. Garbe <arg@suckless.org>
parents:
723
diff
changeset
|
135 .BR dmenu (1) |
723
251047bc6129
renamed CAVEATS into BUGS
Anselm R. Garbe <arg@suckless.org>
parents:
700
diff
changeset
|
136 .SH BUGS |
347 | 137 The status bar may display |
633
7209e355762c
fixed man page, status bar displays EOF instead of "broken pipe"
arg@mig29
parents:
632
diff
changeset
|
138 .BR "EOF" |
632 | 139 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
|
140 .BR xdm (1), |
632 | 141 because those close standard output before executing dwm. |
142 .P | |
143 Java applications which use the XToolkit/XAWT backend may draw grey windows | |
144 only. The XToolkit/XAWT backend breaks ICCCM-compliance in recent JDK 1.5 and early | |
634 | 145 JDK 1.6 versions, because it assumes a reparenting window manager. As a workaround |
146 you can use JDK 1.4 (which doesn't contain the XToolkit/XAWT backend) or you | |
147 can set the following environment variable (to use the older Motif | |
632 | 148 backend instead): |
149 .BR AWT_TOOLKIT=MToolkit . |