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