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@262
|
44 click on a tag label (un)extends the current
|
arg@262
|
45 .B tag.
|
arg@256
|
46 .TP
|
arg@256
|
47 .B Button[1,4]
|
arg@262
|
48 click on the bar focuses the previous
|
arg@262
|
49 .B tag.
|
arg@256
|
50 .TP
|
arg@256
|
51 .B Button[2,5]
|
arg@262
|
52 click on the bar focuses the next
|
arg@262
|
53 .B tag.
|
arg@256
|
54 .SS Keyboard commands
|
garbeam@55
|
55 .TP
|
garbeam@55
|
56 .B Mod1-Return
|
arg@238
|
57 Zoom current
|
garbeam@55
|
58 .B window
|
garbeam@55
|
59 to the
|
garbeam@55
|
60 .B master
|
arg@219
|
61 column.
|
garbeam@55
|
62 .TP
|
arg@160
|
63 .B Mod1-h
|
arg@160
|
64 Focus previous
|
arg@219
|
65 .B tag.
|
arg@160
|
66 .TP
|
arg@160
|
67 .B Mod1-j
|
arg@160
|
68 Focus next
|
arg@219
|
69 .B window.
|
arg@160
|
70 .TP
|
garbeam@55
|
71 .B Mod1-k
|
garbeam@55
|
72 Focus previous
|
arg@219
|
73 .B window.
|
garbeam@55
|
74 .TP
|
arg@160
|
75 .B Mod1-l
|
garbeam@55
|
76 Focus next
|
arg@219
|
77 .B tag.
|
garbeam@55
|
78 .TP
|
garbeam@55
|
79 .B Mod1-m
|
garbeam@55
|
80 Maximize current
|
arg@219
|
81 .B window.
|
garbeam@55
|
82 .TP
|
garbeam@55
|
83 .B Mod1-[0..n]
|
garbeam@55
|
84 Focus
|
arg@219
|
85 .B nth tag.
|
garbeam@55
|
86 .TP
|
garbeam@55
|
87 .B Mod1-space
|
arg@143
|
88 Toggle between
|
arg@143
|
89 .B tiled
|
arg@143
|
90 and
|
arg@143
|
91 .B floating
|
arg@143
|
92 mode (affects
|
arg@219
|
93 .BR "all windows" ).
|
garbeam@56
|
94 .TP
|
garbeam@56
|
95 .B Mod1-Shift-[0..n]
|
garbeam@56
|
96 Apply
|
arg@160
|
97 .B nth tag
|
arg@160
|
98 to current
|
arg@219
|
99 .B window.
|
garbeam@56
|
100 .TP
|
arg@258
|
101 .B Mod1-Shift-c
|
arg@258
|
102 Close focused
|
arg@258
|
103 .B window.
|
arg@258
|
104 .TP
|
garbeam@56
|
105 .B Mod1-Shift-q
|
garbeam@56
|
106 Quit
|
arg@219
|
107 .B dwm.
|
garbeam@56
|
108 .TP
|
garbeam@56
|
109 .B Mod1-Shift-Return
|
garbeam@56
|
110 Start
|
arg@219
|
111 .B terminal.
|
garbeam@56
|
112 .TP
|
arg@131
|
113 .B Mod1-Control-[0..n]
|
garbeam@56
|
114 Append
|
arg@160
|
115 .B nth tag
|
arg@160
|
116 to current
|
arg@219
|
117 .B window.
|
arg@262
|
118 .TP
|
arg@262
|
119 .B Mod1-Control-Shift-[0..n]
|
arg@262
|
120 (Un)extends
|
arg@262
|
121 .B nth tag
|
arg@262
|
122 with current
|
arg@262
|
123 .B tag.
|
arg@256
|
124 .SS Mouse commands
|
garbeam@82
|
125 .TP
|
garbeam@59
|
126 .B Mod1-Button1
|
arg@238
|
127 Move current
|
garbeam@59
|
128 .B window
|
arg@219
|
129 while dragging.
|
garbeam@59
|
130 .TP
|
arg@238
|
131 .B Mod1-Button2
|
arg@238
|
132 Zoom current
|
arg@238
|
133 .B window
|
arg@238
|
134 to the
|
arg@238
|
135 .B master
|
arg@238
|
136 column.
|
arg@238
|
137 .TP
|
garbeam@59
|
138 .B Mod1-Button3
|
arg@238
|
139 Resize current
|
garbeam@59
|
140 .B window
|
arg@219
|
141 while dragging.
|
garbeam@82
|
142 .SH CUSTOMIZATION
|
garbeam@82
|
143 .B dwm
|
arg@174
|
144 is customized by creating a custom config.h and (re)compiling the source
|
arg@174
|
145 code. This keeps it fast, secure and simple.
|
arg@201
|
146 .SH SEE ALSO
|
arg@201
|
147 .BR dmenu (1)
|