author | arg@mig29 |
Fri, 01 Dec 2006 15:03:42 +0100 | |
changeset 602 | 3c765cc4bce4 |
parent 601 | bfea29f1e4a4 |
child 606 | 44b5617c78b3 |
permissions | -rw-r--r-- |
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 |
13 |
area contains the window which currently needs most attention, whereas the |
|
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 | 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 |
719b37b37b0d
using the term 'indicated' instead of 'higlighted'
arg@mig29
parents:
574
diff
changeset
|
24 |
window are indicated with a small point in the top left corner. The tags which |
602 | 25 |
are applied to one or more clients are indicated with a top line. |
316
d69cdb180a3e
small changes to dwm.1, rearranged order within main event loop
Anselm R.Garbe <arg@10ksloc.org>
parents:
293
diff
changeset
|
26 |
.P |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
27 |
dwm draws a 1-pixel border around windows to indicate the focus state. |
342 | 28 |
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
|
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 |
46 |
.B Mod1-Button1 |
|
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
47 |
click on a tag label applies that tag to the focused window. |
398 | 48 |
.TP |
49 |
.B Mod1-Button3 |
|
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
50 |
click on a tag label adds/removes that tag to/from the focused window. |
256 | 51 |
.SS Keyboard commands |
55 | 52 |
.TP |
293 | 53 |
.B Mod1-Shift-Return |
54 |
Start |
|
55 |
.BR xterm (1). |
|
56 |
.TP |
|
57 |
.B Mod1-Tab |
|
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
58 |
Focus next window. |
293 | 59 |
.TP |
60 |
.B Mod1-Shift-Tab |
|
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
61 |
Focus previous window. |
293 | 62 |
.TP |
55 | 63 |
.B Mod1-Return |
504 | 64 |
Zooms/cycles current window to/from master area (tiling mode), toggles maximization current window (floating mode). |
477 | 65 |
.TP |
415
ad2b6ce6e95b
I really need column growing, now pushing upstream
Anselm R. Garbe <arg@10kloc.org>
parents:
398
diff
changeset
|
66 |
.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
|
67 |
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
|
68 |
.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
|
69 |
.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
|
70 |
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
|
71 |
.TP |
396
be3be9590d5c
changed shortcut into Mod1-0
Anselm R. Garbe <arg@10kloc.org>
parents:
395
diff
changeset
|
72 |
.B Mod1-Shift-[1..n] |
293 | 73 |
Apply |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
74 |
.RB nth |
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
75 |
tag to current window. |
293 | 76 |
.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
|
77 |
.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
|
78 |
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
|
79 |
.TP |
396
be3be9590d5c
changed shortcut into Mod1-0
Anselm R. Garbe <arg@10kloc.org>
parents:
395
diff
changeset
|
80 |
.B Mod1-Control-Shift-[1..n] |
293 | 81 |
Add/remove |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
82 |
.B nth |
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
83 |
tag to/from current window. |
293 | 84 |
.TP |
85 |
.B Mod1-Shift-c |
|
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
86 |
Close focused window. |
55 | 87 |
.TP |
88 |
.B Mod1-space |
|
525 | 89 |
Toggle between tiling and floating mode (affects all windows). |
56 | 90 |
.TP |
585 | 91 |
.B Mod1-Shift-space |
592 | 92 |
Toggle focused window between floating and non-floating state (tiling mode only). |
585 | 93 |
.TP |
396
be3be9590d5c
changed shortcut into Mod1-0
Anselm R. Garbe <arg@10kloc.org>
parents:
395
diff
changeset
|
94 |
.B Mod1-[1..n] |
293 | 95 |
View all windows with |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
96 |
.BR nth |
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
97 |
tag. |
56 | 98 |
.TP |
396
be3be9590d5c
changed shortcut into Mod1-0
Anselm R. Garbe <arg@10kloc.org>
parents:
395
diff
changeset
|
99 |
.B Mod1-0 |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
100 |
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
|
101 |
.TP |
396
be3be9590d5c
changed shortcut into Mod1-0
Anselm R. Garbe <arg@10kloc.org>
parents:
395
diff
changeset
|
102 |
.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
|
103 |
Add/remove all windows with |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
104 |
.BR nth |
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
105 |
tag to/from the view. |
264
afcea99a4f3f
updated man page, added CAVEATS section
Anselm R.Garbe <arg@10ksloc.org>
parents:
262
diff
changeset
|
106 |
.TP |
293 | 107 |
.B Mod1-Shift-q |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
108 |
Quit dwm. |
256 | 109 |
.SS Mouse commands |
82 | 110 |
.TP |
59
5d4653de9a1c
implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents:
58
diff
changeset
|
111 |
.B Mod1-Button1 |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
112 |
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
|
113 |
.TP |
238 | 114 |
.B Mod1-Button2 |
504 | 115 |
Zoom current window to the master area (tiling mode only). |
238 | 116 |
.TP |
59
5d4653de9a1c
implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents:
58
diff
changeset
|
117 |
.B Mod1-Button3 |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
118 |
Resize current window while dragging (floating mode only). |
82 | 119 |
.SH CUSTOMIZATION |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
120 |
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
|
121 |
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
|
122 |
.SH CAVEATS |
347 | 123 |
The status bar may display |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
124 |
.BR "broken pipe" |
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
125 |
when dwm has been started by |
264
afcea99a4f3f
updated man page, added CAVEATS section
Anselm R.Garbe <arg@10ksloc.org>
parents:
262
diff
changeset
|
126 |
.BR xdm (1), |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
127 |
because it closes standard output before executing dwm. |
201 | 128 |
.SH SEE ALSO |
129 |
.BR dmenu (1) |