author | Anselm R. Garbe <garbeam@gmail.com> |
Sat, 22 Sep 2007 21:34:06 +0200 | |
changeset 1007 | 1a33d975c9e6 |
parent 1002 | 5cc2be8efeb4 |
child 1019 | cfbff09338fd |
permissions | -rw-r--r-- |
1001
2477f818215c
made all stuff non-static - so you can choose wether to use dwm the static or the extern way when extending it
arg@suckless.org
parents:
999
diff
changeset
|
1 |
.TH DWM 1 dwm\-4.3 |
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 |
|
830
5a4fd8fec414
renamed versatile into untiled
Anselm R. Garbe <arg@suckless.org>
parents:
824
diff
changeset
|
8 |
dwm is a dynamic window manager for X. It manages windows in tiled and |
837
123231b9eb87
renamed untiled into floating, keeping tiled instead of tiling (afaik tiled sounds more correct) - English speakers convinced me
Anselm R. Garbe <arg@suckless.org>
parents:
836
diff
changeset
|
9 |
floating layouts. Either layout can be applied dynamically, optimizing the |
445
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 |
830
5a4fd8fec414
renamed versatile into untiled
Anselm R. Garbe <arg@suckless.org>
parents:
824
diff
changeset
|
12 |
In tiled layout windows are managed in a master and stacking area. The master |
939
a1ac5930ba2f
removed VRATIO, NMASTER, inc*(), renamed HRATIO into MASTER, see mailinglist for details
Anselm R. Garbe <garbeam@gmail.com>
parents:
936
diff
changeset
|
13 |
area contains the window which currently needs most attention, whereas the |
837
123231b9eb87
renamed untiled into floating, keeping tiled instead of tiling (afaik tiled sounds more correct) - English speakers convinced me
Anselm R. Garbe <arg@suckless.org>
parents:
836
diff
changeset
|
14 |
stacking area contains all other windows. In floating layout windows can be |
123231b9eb87
renamed untiled into floating, keeping tiled instead of tiling (afaik tiled sounds more correct) - English speakers convinced me
Anselm R. Garbe <arg@suckless.org>
parents:
836
diff
changeset
|
15 |
resized and moved freely. Dialog windows are always managed floating, |
782
92862ab407d5
introduced Layout struct
Anselm R. Garbe <arg@suckless.org>
parents:
749
diff
changeset
|
16 |
regardless of the layout 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 |
782
92862ab407d5
introduced Layout struct
Anselm R. Garbe <arg@suckless.org>
parents:
749
diff
changeset
|
21 |
dwm contains a small status bar which displays all available tags, the layout, |
818
013954d9fe7a
reusing drawsquare for client title, empty square before title means versatile window, filled square before title means versatile maximized window.
Anselm R. Garbe <arg@suckless.org>
parents:
817
diff
changeset
|
22 |
the title of the focused window, and the text read from standard input. A |
837
123231b9eb87
renamed untiled into floating, keeping tiled instead of tiling (afaik tiled sounds more correct) - English speakers convinced me
Anselm R. Garbe <arg@suckless.org>
parents:
836
diff
changeset
|
23 |
floating window is indicated with an empty square and a maximized |
123231b9eb87
renamed untiled into floating, keeping tiled instead of tiling (afaik tiled sounds more correct) - English speakers convinced me
Anselm R. Garbe <arg@suckless.org>
parents:
836
diff
changeset
|
24 |
floating window is indicated with a filled square before the windows |
818
013954d9fe7a
reusing drawsquare for client title, empty square before title means versatile window, filled square before title means versatile maximized window.
Anselm R. Garbe <arg@suckless.org>
parents:
817
diff
changeset
|
25 |
title. The selected tags are indicated with a different color. The tags of |
013954d9fe7a
reusing drawsquare for client title, empty square before title means versatile window, filled square before title means versatile maximized window.
Anselm R. Garbe <arg@suckless.org>
parents:
817
diff
changeset
|
26 |
the focused window are indicated with a filled square in the top left |
817
90435b444620
dwm draws a small caret before the client title if it's a versatile client
Anselm R. Garbe <arg@suckless.org>
parents:
813
diff
changeset
|
27 |
corner. The tags which are applied to one or more windows are indicated |
90435b444620
dwm draws a small caret before the client title if it's a versatile client
Anselm R. Garbe <arg@suckless.org>
parents:
813
diff
changeset
|
28 |
with an empty square in 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
|
29 |
.P |
700
f05c825db96b
moved BORDERPX to config.*.h
Anselm R. Garbe <arg@suckless.org>
parents:
687
diff
changeset
|
30 |
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
|
31 |
.SH OPTIONS |
0 | 32 |
.TP |
33 |
.B \-v |
|
80
8125f908c80c
several additions in mouse handling ;)
Anselm R. Garbe <garbeam@wmii.de>
parents:
79
diff
changeset
|
34 |
prints version information to standard output, then exits. |
82 | 35 |
.SH USAGE |
256 | 36 |
.SS Status bar |
37 |
.TP |
|
259
d661ecce0c75
applied Sanders fixes to dwm.1
Anselm R.Garbe <arg@10ksloc.org>
parents:
258
diff
changeset
|
38 |
.B Standard input |
d661ecce0c75
applied Sanders fixes to dwm.1
Anselm R.Garbe <arg@10ksloc.org>
parents:
258
diff
changeset
|
39 |
is read and displayed in the status text area. |
256 | 40 |
.TP |
288
b7865e6feef2
applied sanders man page patch, removed button2 from bar click
Anselm R.Garbe <arg@10ksloc.org>
parents:
270
diff
changeset
|
41 |
.B Button1 |
782
92862ab407d5
introduced Layout struct
Anselm R. Garbe <arg@suckless.org>
parents:
749
diff
changeset
|
42 |
click on a tag label to display all windows with that tag, click on the layout |
837
123231b9eb87
renamed untiled into floating, keeping tiled instead of tiling (afaik tiled sounds more correct) - English speakers convinced me
Anselm R. Garbe <arg@suckless.org>
parents:
836
diff
changeset
|
43 |
label toggles between tiled and floating layout. |
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
|
44 |
.TP |
270
dacd3f3c5823
implemented restack behavior (floats are on top in tiled mode)
Anselm R.Garbe <arg@10ksloc.org>
parents:
267
diff
changeset
|
45 |
.B Button3 |
530
451f19d48845
removed the stack position stuff
Anselm R. Garbe <arg@10kloc.org>
parents:
525
diff
changeset
|
46 |
click on a tag label adds/removes all windows with that tag to/from the view. |
398 | 47 |
.TP |
847 | 48 |
.B Mod1\-Button1 |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
49 |
click on a tag label applies that tag to the focused window. |
398 | 50 |
.TP |
847 | 51 |
.B Mod1\-Button3 |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
52 |
click on a tag label adds/removes that tag to/from the focused window. |
256 | 53 |
.SS Keyboard commands |
55 | 54 |
.TP |
847 | 55 |
.B Mod1\-Shift\-Return |
293 | 56 |
Start |
838
168547cc501b
well I agree to several people claiming h/j/k/l is the better default than Tab/S-Tab/g/s for focus and master resizing
Anselm R. Garbe <arg@suckless.org>
parents:
837
diff
changeset
|
57 |
.BR xterm. |
293 | 58 |
.TP |
847 | 59 |
.B Mod1\-Return |
830
5a4fd8fec414
renamed versatile into untiled
Anselm R. Garbe <arg@suckless.org>
parents:
824
diff
changeset
|
60 |
Zooms/cycles current window to/from master area (tiled layout only). |
820
e93d501648ab
fixed order of key bindings described in dwm.1
Anselm R. Garbe <arg@suckless.org>
parents:
818
diff
changeset
|
61 |
.TP |
881
709b1538e1af
added new Mod1-b functionality to dwm(1)
Anselm R. Garbe <arg@suckless.org>
parents:
876
diff
changeset
|
62 |
.B Mod1\-b |
709b1538e1af
added new Mod1-b functionality to dwm(1)
Anselm R. Garbe <arg@suckless.org>
parents:
876
diff
changeset
|
63 |
Shows/hides the status bar. |
709b1538e1af
added new Mod1-b functionality to dwm(1)
Anselm R. Garbe <arg@suckless.org>
parents:
876
diff
changeset
|
64 |
.TP |
939
a1ac5930ba2f
removed VRATIO, NMASTER, inc*(), renamed HRATIO into MASTER, see mailinglist for details
Anselm R. Garbe <garbeam@gmail.com>
parents:
936
diff
changeset
|
65 |
.B Mod1\-h |
a1ac5930ba2f
removed VRATIO, NMASTER, inc*(), renamed HRATIO into MASTER, see mailinglist for details
Anselm R. Garbe <garbeam@gmail.com>
parents:
936
diff
changeset
|
66 |
Decreases the master area width about 5% (tiled layout only). |
a1ac5930ba2f
removed VRATIO, NMASTER, inc*(), renamed HRATIO into MASTER, see mailinglist for details
Anselm R. Garbe <garbeam@gmail.com>
parents:
936
diff
changeset
|
67 |
.TP |
847 | 68 |
.B Mod1\-j |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
69 |
Focus next window. |
293 | 70 |
.TP |
847 | 71 |
.B Mod1\-k |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
72 |
Focus previous window. |
293 | 73 |
.TP |
936
bc99eda6fbcd
applied Jukka's dwm.1 patch
Anselm R. Garbe <garbeam@gmail.com>
parents:
935
diff
changeset
|
74 |
.B Mod1\-l |
939
a1ac5930ba2f
removed VRATIO, NMASTER, inc*(), renamed HRATIO into MASTER, see mailinglist for details
Anselm R. Garbe <garbeam@gmail.com>
parents:
936
diff
changeset
|
75 |
Increases the master area width about 5% (tiled layout 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
|
76 |
.TP |
847 | 77 |
.B Mod1\-m |
1002
5cc2be8efeb4
applied Peter Hartlich's togglemax patch to allow toggling tiled clients to maximum
Anselm R. Garbe <garbeam@gmail.com>
parents:
1001
diff
changeset
|
78 |
Toggles maximization of current window. |
813
0ed770c96e51
several changes, made togglemax extern and separated it from zoom() - moved zoom() and togglemax() into layout.c, changed void (*func)(Arg *) into void (*func)(Arg), changed default keybindings of focusnext/focusprev and incmasterw to h/j/k/l accordingly, made keys in config*h appear alphabetically (special keys first), renamed resizemaster into incmasterw, renamed MASTER into MASTERWIDTH
Anselm R. Garbe <arg@suckless.org>
parents:
785
diff
changeset
|
79 |
.TP |
847 | 80 |
.B Mod1\-Shift\-[1..n] |
293 | 81 |
Apply |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
82 |
.RB nth |
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
83 |
tag to current window. |
293 | 84 |
.TP |
847 | 85 |
.B Mod1\-Shift\-0 |
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
|
86 |
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
|
87 |
.TP |
847 | 88 |
.B Mod1\-Control\-Shift\-[1..n] |
293 | 89 |
Add/remove |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
90 |
.B nth |
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
91 |
tag to/from current window. |
293 | 92 |
.TP |
847 | 93 |
.B Mod1\-Shift\-c |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
94 |
Close focused window. |
55 | 95 |
.TP |
847 | 96 |
.B Mod1\-space |
837
123231b9eb87
renamed untiled into floating, keeping tiled instead of tiling (afaik tiled sounds more correct) - English speakers convinced me
Anselm R. Garbe <arg@suckless.org>
parents:
836
diff
changeset
|
97 |
Toggle between tiled and floating layout (affects all windows). |
56 | 98 |
.TP |
847 | 99 |
.B Mod1\-Shift\-space |
976
7c117df5d202
prepared 4.4.1 bugfix and minor feature enhancement release
Anselm R. Garbe <garbeam@gmail.com>
parents:
939
diff
changeset
|
100 |
Toggle focused window between tiled and floating state. |
585 | 101 |
.TP |
847 | 102 |
.B Mod1\-[1..n] |
293 | 103 |
View 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. |
56 | 106 |
.TP |
847 | 107 |
.B Mod1\-0 |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
108 |
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
|
109 |
.TP |
847 | 110 |
.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
|
111 |
Add/remove all windows with |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
112 |
.BR nth |
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
113 |
tag to/from the view. |
264
afcea99a4f3f
updated man page, added CAVEATS section
Anselm R.Garbe <arg@10ksloc.org>
parents:
262
diff
changeset
|
114 |
.TP |
847 | 115 |
.B Mod1\-Shift\-q |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
116 |
Quit dwm. |
256 | 117 |
.SS Mouse commands |
82 | 118 |
.TP |
847 | 119 |
.B Mod1\-Button1 |
998
854a324f5c92
now tiled windows can be resized/moved, their floating state will be toggled implicitely
Anselm R. Garbe <garbeam@gmail.com>
parents:
976
diff
changeset
|
120 |
Move current window while dragging. Tiled windows will be toggled to the floating state. |
59
5d4653de9a1c
implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents:
58
diff
changeset
|
121 |
.TP |
847 | 122 |
.B Mod1\-Button2 |
999
d036b2f17567
Mod1-Button2 on a floating but not-fixed client will make it tiled again
Anselm R. Garbe <garbeam@gmail.com>
parents:
998
diff
changeset
|
123 |
Zooms/cycles current window to/from master area. If it is floating (but not fixed) it will be toggled to the tiled state instead. |
238 | 124 |
.TP |
847 | 125 |
.B Mod1\-Button3 |
998
854a324f5c92
now tiled windows can be resized/moved, their floating state will be toggled implicitely
Anselm R. Garbe <garbeam@gmail.com>
parents:
976
diff
changeset
|
126 |
Resize current window while dragging. Tiled windows will be toggled to the floating state. |
82 | 127 |
.SH CUSTOMIZATION |
445
00584fe34361
made markups in dwm.1 more consistent
Anselm R. Garbe <arg@10kloc.org>
parents:
444
diff
changeset
|
128 |
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
|
129 |
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
|
130 |
.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
|
131 |
.BR dmenu (1) |
723
251047bc6129
renamed CAVEATS into BUGS
Anselm R. Garbe <arg@suckless.org>
parents:
700
diff
changeset
|
132 |
.SH BUGS |
347 | 133 |
The status bar may display |
633
7209e355762c
fixed man page, status bar displays EOF instead of "broken pipe"
arg@mig29
parents:
632
diff
changeset
|
134 |
.BR "EOF" |
632 | 135 |
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
|
136 |
.BR xdm (1), |
632 | 137 |
because those close standard output before executing dwm. |
138 |
.P |
|
139 |
Java applications which use the XToolkit/XAWT backend may draw grey windows |
|
140 |
only. The XToolkit/XAWT backend breaks ICCCM-compliance in recent JDK 1.5 and early |
|
634 | 141 |
JDK 1.6 versions, because it assumes a reparenting window manager. As a workaround |
142 |
you can use JDK 1.4 (which doesn't contain the XToolkit/XAWT backend) or you |
|
143 |
can set the following environment variable (to use the older Motif |
|
632 | 144 |
backend instead): |
145 |
.BR AWT_TOOLKIT=MToolkit . |
|
876
22c923f7c2d1
added the GTK Save-As bug report to BUGS section of dwm(1)
Anselm R. Garbe <arg@suckless.org>
parents:
847
diff
changeset
|
146 |
.P |
22c923f7c2d1
added the GTK Save-As bug report to BUGS section of dwm(1)
Anselm R. Garbe <arg@suckless.org>
parents:
847
diff
changeset
|
147 |
Recent GTK 2.10.9+ versions contain a broken |
22c923f7c2d1
added the GTK Save-As bug report to BUGS section of dwm(1)
Anselm R. Garbe <arg@suckless.org>
parents:
847
diff
changeset
|
148 |
.BR Save\-As |
22c923f7c2d1
added the GTK Save-As bug report to BUGS section of dwm(1)
Anselm R. Garbe <arg@suckless.org>
parents:
847
diff
changeset
|
149 |
file dialog implementation, |
22c923f7c2d1
added the GTK Save-As bug report to BUGS section of dwm(1)
Anselm R. Garbe <arg@suckless.org>
parents:
847
diff
changeset
|
150 |
which requests to reconfigure its window size in an endless loop. However, its |
22c923f7c2d1
added the GTK Save-As bug report to BUGS section of dwm(1)
Anselm R. Garbe <arg@suckless.org>
parents:
847
diff
changeset
|
151 |
window is still respondable during this state, so you can simply ignore the flicker |
22c923f7c2d1
added the GTK Save-As bug report to BUGS section of dwm(1)
Anselm R. Garbe <arg@suckless.org>
parents:
847
diff
changeset
|
152 |
until a new GTK version appears, which will fix this bug, approximately |
22c923f7c2d1
added the GTK Save-As bug report to BUGS section of dwm(1)
Anselm R. Garbe <arg@suckless.org>
parents:
847
diff
changeset
|
153 |
GTK 2.10.12+ versions. |