rev |
line source |
arg@212
|
1 .TH DWM 1 dwm-VERSION
|
garbeam@0
|
2 .SH NAME
|
garbeam@39
|
3 dwm \- dynamic window manager
|
garbeam@0
|
4 .SH SYNOPSIS
|
garbeam@38
|
5 .B dwm
|
garbeam@0
|
6 .RB [ \-v ]
|
garbeam@0
|
7 .SH DESCRIPTION
|
garbeam@38
|
8 .B dwm
|
garbeam@82
|
9 is a dynamic window manager for X11. It manages windows in tiling and floating
|
arg@174
|
10 modes. Either mode can be applied dynamically, optimizing the environment for
|
arg@174
|
11 the application in use and the task performed.
|
garbeam@79
|
12 .P
|
garbeam@82
|
13 In tiling mode windows are managed in a master and stacking column. The master
|
arg@174
|
14 column contains the window which currently needs most attention, whereas the
|
arg@174
|
15 stacking column contains all other windows. In floating mode windows can be
|
arg@174
|
16 resized and moved freely. Dialog windows are always managed floating,
|
arg@174
|
17 regardless of the mode selected.
|
garbeam@80
|
18 .P
|
arg@174
|
19 Windows are grouped by tags. Each window can be tagged with one or multiple
|
arg@174
|
20 tags. Selecting a certain tag for viewing will display all windows with that
|
arg@174
|
21 tag.
|
garbeam@79
|
22 .P
|
garbeam@83
|
23 .B dwm
|
arg@174
|
24 has a small status bar which displays the text read from standard
|
arg@174
|
25 input, if written. Besides that, it displays all available tags, and the title
|
arg@174
|
26 of the focused window. It draws a 1-pixel border around windows to
|
arg@174
|
27 indicate the focus state. Unfocused windows contain a small bar in front of
|
arg@174
|
28 them displaying their tags and title.
|
garbeam@80
|
29 .SH OPTIONS
|
garbeam@0
|
30 .TP
|
garbeam@0
|
31 .B \-v
|
garbeam@80
|
32 prints version information to standard output, then exits.
|
garbeam@82
|
33 .SH USAGE
|
arg@256
|
34 .SS Status bar
|
arg@256
|
35 .TP
|
arg@259
|
36 .B Standard input
|
arg@259
|
37 is read and displayed in the status text area.
|
arg@256
|
38 .TP
|
arg@262
|
39 .B Button[1,3]
|
arg@262
|
40 click on a tag label focuses that
|
arg@262
|
41 .B tag.
|
arg@262
|
42 .TP
|
arg@262
|
43 .B Button2
|
arg@264
|
44 click on a tag label toggles that
|
arg@262
|
45 .B tag.
|
arg@256
|
46 .SS Keyboard commands
|
garbeam@55
|
47 .TP
|
garbeam@55
|
48 .B Mod1-Return
|
arg@238
|
49 Zoom current
|
garbeam@55
|
50 .B window
|
garbeam@55
|
51 to the
|
garbeam@55
|
52 .B master
|
arg@219
|
53 column.
|
garbeam@55
|
54 .TP
|
arg@160
|
55 .B Mod1-j
|
arg@160
|
56 Focus next
|
arg@219
|
57 .B window.
|
arg@160
|
58 .TP
|
garbeam@55
|
59 .B Mod1-k
|
garbeam@55
|
60 Focus previous
|
arg@219
|
61 .B window.
|
garbeam@55
|
62 .TP
|
garbeam@55
|
63 .B Mod1-m
|
garbeam@55
|
64 Maximize current
|
arg@219
|
65 .B window.
|
garbeam@55
|
66 .TP
|
garbeam@55
|
67 .B Mod1-[0..n]
|
garbeam@55
|
68 Focus
|
arg@219
|
69 .B nth tag.
|
garbeam@55
|
70 .TP
|
garbeam@55
|
71 .B Mod1-space
|
arg@143
|
72 Toggle between
|
arg@143
|
73 .B tiled
|
arg@143
|
74 and
|
arg@143
|
75 .B floating
|
arg@143
|
76 mode (affects
|
arg@219
|
77 .BR "all windows" ).
|
garbeam@56
|
78 .TP
|
garbeam@56
|
79 .B Mod1-Shift-[0..n]
|
garbeam@56
|
80 Apply
|
arg@160
|
81 .B nth tag
|
arg@160
|
82 to current
|
arg@219
|
83 .B window.
|
garbeam@56
|
84 .TP
|
arg@258
|
85 .B Mod1-Shift-c
|
arg@258
|
86 Close focused
|
arg@258
|
87 .B window.
|
arg@258
|
88 .TP
|
garbeam@56
|
89 .B Mod1-Shift-q
|
garbeam@56
|
90 Quit
|
arg@219
|
91 .B dwm.
|
garbeam@56
|
92 .TP
|
garbeam@56
|
93 .B Mod1-Shift-Return
|
garbeam@56
|
94 Start
|
arg@219
|
95 .B terminal.
|
garbeam@56
|
96 .TP
|
arg@131
|
97 .B Mod1-Control-[0..n]
|
arg@264
|
98 Toggle
|
arg@264
|
99 .B nth tag.
|
arg@264
|
100 .TP
|
arg@264
|
101 .B Mod1-Control-Shift-[0..n]
|
garbeam@56
|
102 Append
|
arg@160
|
103 .B nth tag
|
arg@160
|
104 to current
|
arg@219
|
105 .B window.
|
arg@256
|
106 .SS Mouse commands
|
garbeam@82
|
107 .TP
|
garbeam@59
|
108 .B Mod1-Button1
|
arg@238
|
109 Move current
|
garbeam@59
|
110 .B window
|
arg@219
|
111 while dragging.
|
garbeam@59
|
112 .TP
|
arg@238
|
113 .B Mod1-Button2
|
arg@238
|
114 Zoom current
|
arg@238
|
115 .B window
|
arg@238
|
116 to the
|
arg@238
|
117 .B master
|
arg@238
|
118 column.
|
arg@238
|
119 .TP
|
garbeam@59
|
120 .B Mod1-Button3
|
arg@238
|
121 Resize current
|
garbeam@59
|
122 .B window
|
arg@219
|
123 while dragging.
|
garbeam@82
|
124 .SH CUSTOMIZATION
|
garbeam@82
|
125 .B dwm
|
arg@174
|
126 is customized by creating a custom config.h and (re)compiling the source
|
arg@174
|
127 code. This keeps it fast, secure and simple.
|
arg@264
|
128 .SH CAVEATS
|
arg@264
|
129 The status bar displays
|
arg@264
|
130 .BR "broken pipe"
|
arg@264
|
131 when
|
arg@264
|
132 .B dwm
|
arg@264
|
133 has been started by
|
arg@264
|
134 .BR xdm (1),
|
arg@264
|
135 because it closes standard output before executing
|
arg@264
|
136 .B dwm.
|
arg@201
|
137 .SH SEE ALSO
|
arg@201
|
138 .BR dmenu (1)
|