aewl

view dwm.1 @ 415:ad2b6ce6e95b

I really need column growing, now pushing upstream
author Anselm R. Garbe <arg@10kloc.org>
date Tue, 05 Sep 2006 09:02:37 +0200
parents 9c703e528e58
children ca2d99d8b8fc
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-Shift-[1..n]
100 Apply
101 .B nth tag
102 to current
103 .BR window .
104 .TP
105 .B Mod1-Control-Shift-[1..n]
106 Add/remove
107 .B nth tag
108 to/from current
109 .BR window .
110 .TP
111 .B Mod1-Shift-c
112 Close focused
113 .B window.
114 .TP
115 .B Mod1-space
116 Toggle between
117 .B tiled
118 and
119 .B floating
120 mode (affects
121 .BR "all windows" ).
122 .TP
123 .B Mod1-[1..n]
124 View all windows with
125 .BR "tag n" .
126 .TP
127 .B Mod1-0
128 View all windows with any
129 .BR "tag" .
130 .TP
131 .B Mod1-Control-[1..n]
132 Add/remove all windows with
133 .B tag n
134 to/from the view.
135 .TP
136 .B Mod1-Shift-q
137 Quit
138 .B dwm.
139 .SS Mouse commands
140 .TP
141 .B Mod1-Button1
142 Move current
143 .B window
144 while dragging
145 .RB ( floating
146 mode only).
147 .TP
148 .B Mod1-Button2
149 Zoom current
150 .B window
151 to the
152 .B master
153 column
154 .RB ( tiling
155 mode only).
156 .TP
157 .B Mod1-Button3
158 Resize current
159 .B window
160 while dragging
161 .RB ( floating
162 mode only).
163 .SH CUSTOMIZATION
164 .B dwm
165 is customized by creating a custom config.h and (re)compiling the source
166 code. This keeps it fast, secure and simple.
167 .SH CAVEATS
168 The status bar may display
169 .B broken pipe
170 when
171 .B dwm
172 has been started by
173 .BR xdm (1),
174 because it closes standard output before executing
175 .BR dwm .
176 .SH SEE ALSO
177 .BR dmenu (1)