aewl
view dwm.1 @ 329:cea0c98495bc
rearranged getproto
| author | Anselm R. Garbe <arg@10kloc.org> |
|---|---|
| date | Tue, 22 Aug 2006 17:40:21 +0200 |
| parents | 093744cc5353 |
| children | c5bea7c0231b |
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 the text read from standard
25 input. Besides that, it displays all available tags, and the title
26 of the focused window.
27 .P
28 .B dwm draws a 1-pixel border around windows to indicate the focus state.
29 Unfocused windows contain a small bar in front of them displaying their tags
30 and 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 .TP
45 .B Button3
46 click on a tag label adds/removes all windows with that
47 .B tag
48 to/from the view.
49 .SS Keyboard commands
50 .TP
51 .B Mod1-Shift-Return
52 Start
53 .BR xterm (1).
54 .TP
55 .B Mod1-Tab
56 Focus next
57 .BR window .
58 .TP
59 .B Mod1-Shift-Tab
60 Focus previous
61 .BR window .
62 .TP
63 .B Mod1-Return
64 Zoom current
65 .B window
66 to the
67 .B master
68 column
69 .RB ( tiling
70 mode only).
71 .TP
72 .B Mod1-m
73 Maximize current
74 .BR window .
75 .TP
76 .B Mod1-Shift-[0..n]
77 Apply
78 .B nth tag
79 to current
80 .BR window .
81 .TP
82 .B Mod1-Control-Shift-[0..n]
83 Add/remove
84 .B nth tag
85 to/from current
86 .BR window .
87 .TP
88 .B Mod1-Shift-c
89 Close focused
90 .B window.
91 .TP
92 .B Mod1-space
93 Toggle between
94 .B tiled
95 and
96 .B floating
97 mode (affects
98 .BR "all windows" ).
99 .TP
100 .B Mod1-[0..n]
101 View all windows with
102 .BR "tag n" .
103 .TP
104 .B Mod1-Control-[0..n]
105 Add/remove all windows with
106 .B tag n
107 to/from the view.
108 .TP
109 .B Mod1-Shift-q
110 Quit
111 .B dwm.
112 .SS Mouse commands
113 .TP
114 .B Mod1-Button1
115 Move current
116 .B window
117 while dragging
118 .RB ( floating
119 mode only).
120 .TP
121 .B Mod1-Button2
122 Zoom current
123 .B window
124 to the
125 .B master
126 column
127 .RB ( tiling
128 mode only).
129 .TP
130 .B Mod1-Button3
131 Resize current
132 .B window
133 while dragging
134 .RB ( floating
135 mode only).
136 .SH CUSTOMIZATION
137 .B dwm
138 is customized by creating a custom config.h and (re)compiling the source
139 code. This keeps it fast, secure and simple.
140 .SH CAVEATS
141 The status bar displays
142 .B broken pipe
143 when
144 .B dwm
145 has been started by
146 .BR xdm (1),
147 because it closes standard output before executing
148 .BR dwm .
149 .SH SEE ALSO
150 .BR dmenu (1)