aewl

view dwm.1 @ 441:785bad5f21dd

does this preserve z order for anthony?
author Anselm R. Garbe <arg@10kloc.org>
date Wed, 06 Sep 2006 15:30:28 +0200
parents ad2b6ce6e95b
children 48038934d05d
line source
1 .TH DWM 1 dwm-VERSION
2 .SH NAME
3 dwm \- dynamic window manager
4 .SH SYNOPSIS
5 .B dwm
6 .RB [ \-v ]
7 .SH DESCRIPTION
8 .B dwm
9 is a dynamic window manager for X. It manages windows in tiling and floating
10 modes. Either mode can be applied dynamically, optimizing the environment for
11 the application in use and the task performed.
12 .P
13 In tiling mode windows are managed in a master and stacking column. The master
14 column contains the window which currently needs most attention, whereas the
15 stacking column contains all other windows. In floating mode windows can be
16 resized and moved freely. Dialog windows are always managed floating,
17 regardless of the mode selected.
18 .P
19 Windows are grouped by tags. Each window can be tagged with one or multiple
20 tags. Selecting a certain tag for viewing will display all windows with that
21 tag.
22 .P
23 .B dwm
24 contains a small status bar which displays all available tags, the mode, the
25 title of the focused window, and the text read from standard input. The tags of
26 the focused window are highlighted with a small point.
27 .P
28 .B dwm
29 draws a 1-pixel border around windows to indicate the focus state.
30 Unfocused windows contain a small bar in front of them displaying their title.
31 .SH OPTIONS
32 .TP
33 .B \-v
34 prints version information to standard output, then exits.
35 .SH USAGE
36 .SS Status bar
37 .TP
38 .B Standard input
39 is read and displayed in the status text area.
40 .TP
41 .B Button1
42 click on a tag label views all windows with that
43 .BR tag ,
44 click on the mode label toggles between
45 .B tiled
46 and
47 .B floating
48 mode.
49 .TP
50 .B Button3
51 click on a tag label adds/removes all windows with that
52 .B tag
53 to/from the view.
54 .TP
55 .B Mod1-Button1
56 click on a tag label applies that
57 .B tag
58 to the focused
59 .BR window .
60 .TP
61 .B Mod1-Button3
62 click on a tag label adds/removes that
63 .B tag
64 to/from the focused
65 .BR window .
66 .SS Keyboard commands
67 .TP
68 .B Mod1-Shift-Return
69 Start
70 .BR xterm (1).
71 .TP
72 .B Mod1-Tab
73 Focus next
74 .BR window .
75 .TP
76 .B Mod1-Shift-Tab
77 Focus previous
78 .BR window .
79 .TP
80 .B Mod1-Return
81 Zoom current
82 .B window
83 to the
84 .B master
85 column
86 .RB ( tiling
87 mode only).
88 .TP
89 .B Mod1-m
90 Maximize current
91 .BR window .
92 .TP
93 .B Mod1-g
94 Grow current
95 .BR column
96 .RB ( tiling
97 mode only).
98 .TP
99 .B Mod1-s
100 Shrink current
101 .BR column
102 .RB ( tiling
103 mode only).
104 .TP
105 .B Mod1-Shift-[1..n]
106 Apply
107 .B nth tag
108 to current
109 .BR window .
110 .TP
111 .B Mod1-Control-Shift-[1..n]
112 Add/remove
113 .B nth tag
114 to/from current
115 .BR window .
116 .TP
117 .B Mod1-Shift-c
118 Close focused
119 .B window.
120 .TP
121 .B Mod1-space
122 Toggle between
123 .B tiled
124 and
125 .B floating
126 mode (affects
127 .BR "all windows" ).
128 .TP
129 .B Mod1-[1..n]
130 View all windows with
131 .BR "tag n" .
132 .TP
133 .B Mod1-0
134 View all windows with any
135 .BR "tag" .
136 .TP
137 .B Mod1-Control-[1..n]
138 Add/remove all windows with
139 .B tag n
140 to/from the view.
141 .TP
142 .B Mod1-Shift-q
143 Quit
144 .B dwm.
145 .SS Mouse commands
146 .TP
147 .B Mod1-Button1
148 Move current
149 .B window
150 while dragging
151 .RB ( floating
152 mode only).
153 .TP
154 .B Mod1-Button2
155 Zoom current
156 .B window
157 to the
158 .B master
159 column
160 .RB ( tiling
161 mode only).
162 .TP
163 .B Mod1-Button3
164 Resize current
165 .B window
166 while dragging
167 .RB ( floating
168 mode only).
169 .SH CUSTOMIZATION
170 .B dwm
171 is customized by creating a custom config.h and (re)compiling the source
172 code. This keeps it fast, secure and simple.
173 .SH CAVEATS
174 The status bar may display
175 .B broken pipe
176 when
177 .B dwm
178 has been started by
179 .BR xdm (1),
180 because it closes standard output before executing
181 .BR dwm .
182 .SH SEE ALSO
183 .BR dmenu (1)