aewl

view dwm.1 @ 342:a1901753deef

updated man page
author Anselm R. Garbe <arg@10kloc.org>
date Wed, 23 Aug 2006 18:50:46 +0200
parents e4dad4635250
children b423154eb7be
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 title
25 of the focused window, and the text read from standard input. The tags of the
26 focused window are highlighted.
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 title.
30 .SH OPTIONS
31 .TP
32 .B \-v
33 prints version information to standard output, then exits.
34 .SH USAGE
35 .SS Status bar
36 .TP
37 .B Standard input
38 is read and displayed in the status text area.
39 .TP
40 .B Button1
41 click on a tag label views all windows with that
42 .BR tag .
43 .TP
44 .B Button3
45 click on a tag label adds/removes all windows with that
46 .B tag
47 to/from the view.
48 .SS Keyboard commands
49 .TP
50 .B Mod1-Shift-Return
51 Start
52 .BR xterm (1).
53 .TP
54 .B Mod1-Tab
55 Focus next
56 .BR window .
57 .TP
58 .B Mod1-Shift-Tab
59 Focus previous
60 .BR window .
61 .TP
62 .B Mod1-Return
63 Zoom current
64 .B window
65 to the
66 .B master
67 column
68 .RB ( tiling
69 mode only).
70 .TP
71 .B Mod1-m
72 Maximize current
73 .BR window .
74 .TP
75 .B Mod1-Shift-[0..n]
76 Apply
77 .B nth tag
78 to current
79 .BR window .
80 .TP
81 .B Mod1-Control-Shift-[0..n]
82 Add/remove
83 .B nth tag
84 to/from current
85 .BR window .
86 .TP
87 .B Mod1-Shift-c
88 Close focused
89 .B window.
90 .TP
91 .B Mod1-space
92 Toggle between
93 .B tiled
94 and
95 .B floating
96 mode (affects
97 .BR "all windows" ).
98 .TP
99 .B Mod1-[0..n]
100 View all windows with
101 .BR "tag n" .
102 .TP
103 .B Mod1-Control-[0..n]
104 Add/remove all windows with
105 .B tag n
106 to/from the view.
107 .TP
108 .B Mod1-Shift-q
109 Quit
110 .B dwm.
111 .SS Mouse commands
112 .TP
113 .B Mod1-Button1
114 Move current
115 .B window
116 while dragging
117 .RB ( floating
118 mode only).
119 .TP
120 .B Mod1-Button2
121 Zoom current
122 .B window
123 to the
124 .B master
125 column
126 .RB ( tiling
127 mode only).
128 .TP
129 .B Mod1-Button3
130 Resize current
131 .B window
132 while dragging
133 .RB ( floating
134 mode only).
135 .SH CUSTOMIZATION
136 .B dwm
137 is customized by creating a custom config.h and (re)compiling the source
138 code. This keeps it fast, secure and simple.
139 .SH CAVEATS
140 The status bar displays
141 .B broken pipe
142 when
143 .B dwm
144 has been started by
145 .BR xdm (1),
146 because it closes standard output before executing
147 .BR dwm .
148 .SH SEE ALSO
149 .BR dmenu (1)