dwm-meillo
view dwm.1 @ 395:7528080beb0e
added viewall to mainstream (only Ross Mohns version, not the toggle)
| author | Anselm R. Garbe <arg@10kloc.org> |
|---|---|
| date | Thu, 31 Aug 2006 18:02:38 +0200 |
| parents | 1da9a6b94ca9 |
| children | be3be9590d5c |
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 Button2
51 click on a tag label adds/removes that
52 .B tag
53 to/from the focused
54 .B window.
55 .TP
56 .B Button3
57 click on a tag label adds/removes all windows with that
58 .B tag
59 to/from the view.
60 .SS Keyboard commands
61 .TP
62 .B Mod1-Shift-Return
63 Start
64 .BR xterm (1).
65 .TP
66 .B Mod1-Tab
67 Focus next
68 .BR window .
69 .TP
70 .B Mod1-Shift-Tab
71 Focus previous
72 .BR window .
73 .TP
74 .B Mod1-Return
75 Zoom current
76 .B window
77 to the
78 .B master
79 column
80 .RB ( tiling
81 mode only).
82 .TP
83 .B Mod1-m
84 Maximize current
85 .BR window .
86 .TP
87 .B Mod1-Shift-[0..n]
88 Apply
89 .B nth tag
90 to current
91 .BR window .
92 .TP
93 .B Mod1-Control-Shift-[0..n]
94 Add/remove
95 .B nth tag
96 to/from current
97 .BR window .
98 .TP
99 .B Mod1-Shift-c
100 Close focused
101 .B window.
102 .TP
103 .B Mod1-space
104 Toggle between
105 .B tiled
106 and
107 .B floating
108 mode (affects
109 .BR "all windows" ).
110 .TP
111 .B Mod1-[0..n]
112 View all windows with
113 .BR "tag n" .
114 .TP
115 .B Mod1-a
116 View all windows with any
117 .BR "tag" .
118 .TP
119 .B Mod1-Control-[0..n]
120 Add/remove all windows with
121 .B tag n
122 to/from the view.
123 .TP
124 .B Mod1-Shift-q
125 Quit
126 .B dwm.
127 .SS Mouse commands
128 .TP
129 .B Mod1-Button1
130 Move current
131 .B window
132 while dragging
133 .RB ( floating
134 mode only).
135 .TP
136 .B Mod1-Button2
137 Zoom current
138 .B window
139 to the
140 .B master
141 column
142 .RB ( tiling
143 mode only).
144 .TP
145 .B Mod1-Button3
146 Resize current
147 .B window
148 while dragging
149 .RB ( floating
150 mode only).
151 .SH CUSTOMIZATION
152 .B dwm
153 is customized by creating a custom config.h and (re)compiling the source
154 code. This keeps it fast, secure and simple.
155 .SH CAVEATS
156 The status bar may display
157 .B broken pipe
158 when
159 .B dwm
160 has been started by
161 .BR xdm (1),
162 because it closes standard output before executing
163 .BR dwm .
164 .SH SEE ALSO
165 .BR dmenu (1)