annotate dwm.1 @ 79:aabebd6e61f3

fixed XSync handling and finished man page
author Anselm R. Garbe <garbeam@wmii.de>
date Sat, 15 Jul 2006 18:51:44 +0200
parents d31b5ad96b0b
children 8125f908c80c
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
68
d31b5ad96b0b prep 0.1
Anselm R. Garbe <garbeam@wmii.de>
parents: 59
diff changeset
1 .TH DWM 1 dwm-0.1
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
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
8 .SS Overview
38
678730a1339b updated man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 34
diff changeset
9 .B dwm
79
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
10 is a dynamic window manager for X11. It consists of a small status bar at the
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
11 top of the screen and arranges windows in either a tiled or floating mode.
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
12 .P
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
13 If
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
14 .B dwm
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
15 is in tiled mode, it consists of two columns. The left master column
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
16 contains only one window per time, the right column contains all other windows
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
17 in a stack. In tiled mode
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
18 .B dwm
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
19 .B don't
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
20 handles incremental resizals, some terminal programs like
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
21 .B xterm
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
22 may not work correctly with this in tiled mode.
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
23 .P
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
24 If
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
25 .B dwm
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
26 is in floating mode, it arranges all windows with the reqyested geometry and
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
27 allows the user to move or resize them. Some windows, like
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
28 dialog windows, are treated floating even if
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
29 .B dwm
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
30 is in tiled mode. In floating mode
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
31 .B dwm
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
32 handles incremental resizals.
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
33 .P
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
34 Windows are grouped by tags. You can view all windows with a specific tag per
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
35 time. However, each window is allowed to contain more than one tag, which
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
36 allows to make windows visible in all views.
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
37 .P
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
38 .B dwm
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
39 reads from
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
40 .I stdin
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
41 to display status text, if written.
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
42 .P
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
43 .B dwm
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
44 draws 1-pixel borders around windows to indicate the focus state and save as
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
45 much screen real estate as possible. Unfocused windows contain a small bar
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
46 in front of the window indicating the tags and the window title.
0
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
47 .SS Options
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
48 .TP
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
49 .B \-v
79
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
50 prints version information to
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
51 .I stdout
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
52 , then exits.
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
53 .SS Customization
58
1269bd127551 made barclick to select the specific tag
Anselm R. Garbe <garbeam@wmii.de>
parents: 56
diff changeset
54 .B dwm
79
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
55 is customized through editing its source code. It is assumed that
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
56 dwm users are high experienced users who know how a window manager works
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
57 and who are able to patch
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
58 .B dwm
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
59 for their needs. This keeps
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
60 .B dwm
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
61 fast, secure and simple, because it does not process any input data, except
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
62 window properties and the status text read from
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
63 .I stdin .
55
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
64 .SS Default Key Bindings
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
65 .TP 16
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
66 .I Key
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
67 .I Action
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
68 .TP
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
69 .B Mod1-Return
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
70 Zoom
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
71 .B window
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
72 to the
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
73 .B master
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
74 track
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
75 .TP
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
76 .B Mod1-k
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
77 Focus previous
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
78 .B window
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
79 .TP
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
80 .B Mod1-j
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
81 Focus next
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
82 .B window
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
83 .TP
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
84 .B Mod1-m
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
85 Maximize current
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
86 .B window
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
87 .TP
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
88 .B Mod1-[0..n]
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
89 Focus
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
90 .B nth
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
91 tag
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
92 .TP
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
93 .B Mod1-space
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
94 (Re-)arrange
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
95 .B all
fcbf7213d96f continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 39
diff changeset
96 windows tiled
56
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
97 .TP
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
98 .B Mod1-Shift-space
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
99 (Re-)arrange
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
100 .B all
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
101 windows floating
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
102 .TP
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
103 .B Mod1-Shift-[0..n]
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
104 Apply
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
105 .B nth
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
106 tag to current
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
107 .B window
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
108 .TP
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
109 .B Mod1-Shift-q
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
110 Quit
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
111 .B dwm
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
112 .TP
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
113 .B Mod1-Shift-Return
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
114 Start
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
115 .B terminal
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
116 .TP
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
117 .B Mod1-Shift-w
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
118 Start
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
119 .B web browser
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
120 .TP
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
121 .B Mod1-Shift-l
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
122 Lock
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
123 .B screen
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
124 .TP
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
125 .B Control-[0..n]
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
126 Append
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
127 .B nth
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
128 tag to cureent
b72b7086c385 continued with man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 55
diff changeset
129 .B window
59
5d4653de9a1c implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents: 58
diff changeset
130 .SS Default Mouse Bindings
5d4653de9a1c implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents: 58
diff changeset
131 .TP
5d4653de9a1c implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents: 58
diff changeset
132 .B Mod1-Button1
5d4653de9a1c implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents: 58
diff changeset
133 Moves current
5d4653de9a1c implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents: 58
diff changeset
134 .B window
5d4653de9a1c implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents: 58
diff changeset
135 while dragging
5d4653de9a1c implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents: 58
diff changeset
136 .TP
5d4653de9a1c implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents: 58
diff changeset
137 .B Mod1-Button2
5d4653de9a1c implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents: 58
diff changeset
138 Lowers current
5d4653de9a1c implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents: 58
diff changeset
139 .B window
5d4653de9a1c implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents: 58
diff changeset
140 .TP
5d4653de9a1c implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents: 58
diff changeset
141 .B Mod1-Button3
5d4653de9a1c implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents: 58
diff changeset
142 Resizes current
5d4653de9a1c implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents: 58
diff changeset
143 .B window
5d4653de9a1c implemented dwm reading status text from stdin
Anselm R. Garbe <garbeam@wmii.de>
parents: 58
diff changeset
144 while dragging
79
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
145 .SH BUGS
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
146 Some terminal programs do not behave correctly in tiled mode, because
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
147 incremental resizals are ignored to use maximum screen real estate. You can
aabebd6e61f3 fixed XSync handling and finished man page
Anselm R. Garbe <garbeam@wmii.de>
parents: 68
diff changeset
148 patch the code to fix this.