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