| 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
|
|
arg@445
|
8 dwm is a dynamic window manager for X. It manages windows in tiling and
|
|
arg@445
|
9 floating modes. Either mode can be applied dynamically, optimizing the
|
|
arg@445
|
10 environment for the application in use and the task performed.
|
|
garbeam@79
|
11 .P
|
|
garbeam@82
|
12 In tiling mode windows are managed in a master and stacking column. The master
|
|
arg@174
|
13 column contains the window which currently needs most attention, whereas the
|
|
arg@174
|
14 stacking column contains all other windows. In floating mode windows can be
|
|
arg@174
|
15 resized and moved freely. Dialog windows are always managed floating,
|
|
arg@174
|
16 regardless of the mode selected.
|
|
garbeam@80
|
17 .P
|
|
arg@174
|
18 Windows are grouped by tags. Each window can be tagged with one or multiple
|
|
arg@470
|
19 tags. Selecting certain tags displays all windows with these tags.
|
|
garbeam@79
|
20 .P
|
|
arg@445
|
21 dwm contains a small status bar which displays all available tags, the mode,
|
|
arg@445
|
22 the title of the focused window, and the text read from standard input. The
|
|
arg@444
|
23 selected tags are highlighted with a different color, the tags of the focused
|
|
arg@444
|
24 window are highlighted with a small point.
|
|
arg@316
|
25 .P
|
|
arg@445
|
26 dwm draws a 1-pixel border around windows to indicate the focus state.
|
|
arg@342
|
27 Unfocused windows contain a small bar in front of them displaying their title.
|
|
garbeam@80
|
28 .SH OPTIONS
|
|
garbeam@0
|
29 .TP
|
|
garbeam@0
|
30 .B \-v
|
|
garbeam@80
|
31 prints version information to standard output, then exits.
|
|
garbeam@82
|
32 .SH USAGE
|
|
arg@256
|
33 .SS Status bar
|
|
arg@256
|
34 .TP
|
|
arg@259
|
35 .B Standard input
|
|
arg@259
|
36 is read and displayed in the status text area.
|
|
arg@256
|
37 .TP
|
|
arg@288
|
38 .B Button1
|
|
arg@449
|
39 click on a tag label to display all windows with that tag, click on the mode
|
|
arg@449
|
40 label toggles between tiled and floating mode.
|
|
arg@262
|
41 .TP
|
|
arg@270
|
42 .B Button3
|
|
arg@445
|
43 click on a tag label adds/removes all windows with that tag to/from the view.
|
|
arg@398
|
44 .TP
|
|
arg@398
|
45 .B Mod1-Button1
|
|
arg@445
|
46 click on a tag label applies that tag to the focused window.
|
|
arg@398
|
47 .TP
|
|
arg@398
|
48 .B Mod1-Button3
|
|
arg@445
|
49 click on a tag label adds/removes that tag to/from the focused window.
|
|
arg@256
|
50 .SS Keyboard commands
|
|
garbeam@55
|
51 .TP
|
|
arg@293
|
52 .B Mod1-Shift-Return
|
|
arg@293
|
53 Start
|
|
arg@293
|
54 .BR xterm (1).
|
|
arg@293
|
55 .TP
|
|
arg@293
|
56 .B Mod1-Tab
|
|
arg@445
|
57 Focus next window.
|
|
arg@293
|
58 .TP
|
|
arg@293
|
59 .B Mod1-Shift-Tab
|
|
arg@445
|
60 Focus previous window.
|
|
arg@293
|
61 .TP
|
|
garbeam@55
|
62 .B Mod1-Return
|
|
arg@483
|
63 Zooms/cycles current window to/from master column (tiling mode), toggles maximization current window (floating mode).
|
|
arg@477
|
64 .TP
|
|
arg@415
|
65 .B Mod1-g
|
|
arg@445
|
66 Grow current column (tiling mode only).
|
|
arg@415
|
67 .TP
|
|
arg@421
|
68 .B Mod1-s
|
|
arg@445
|
69 Shrink current column (tiling mode only).
|
|
arg@421
|
70 .TP
|
|
arg@396
|
71 .B Mod1-Shift-[1..n]
|
|
arg@293
|
72 Apply
|
|
arg@445
|
73 .RB nth
|
|
arg@445
|
74 tag to current window.
|
|
arg@293
|
75 .TP
|
|
arg@396
|
76 .B Mod1-Control-Shift-[1..n]
|
|
arg@293
|
77 Add/remove
|
|
arg@445
|
78 .B nth
|
|
arg@445
|
79 tag to/from current window.
|
|
arg@293
|
80 .TP
|
|
arg@293
|
81 .B Mod1-Shift-c
|
|
arg@445
|
82 Close focused window.
|
|
garbeam@55
|
83 .TP
|
|
garbeam@55
|
84 .B Mod1-space
|
|
arg@445
|
85 Toggle between tiled and floating mode (affects all windows).
|
|
garbeam@56
|
86 .TP
|
|
arg@396
|
87 .B Mod1-[1..n]
|
|
arg@293
|
88 View all windows with
|
|
arg@445
|
89 .BR nth
|
|
arg@445
|
90 tag.
|
|
garbeam@56
|
91 .TP
|
|
arg@396
|
92 .B Mod1-0
|
|
arg@445
|
93 View all windows with any tag.
|
|
arg@395
|
94 .TP
|
|
arg@396
|
95 .B Mod1-Control-[1..n]
|
|
arg@288
|
96 Add/remove all windows with
|
|
arg@445
|
97 .BR nth
|
|
arg@445
|
98 tag to/from the view.
|
|
arg@264
|
99 .TP
|
|
arg@293
|
100 .B Mod1-Shift-q
|
|
arg@445
|
101 Quit dwm.
|
|
arg@256
|
102 .SS Mouse commands
|
|
garbeam@82
|
103 .TP
|
|
garbeam@59
|
104 .B Mod1-Button1
|
|
arg@445
|
105 Move current window while dragging (floating mode only).
|
|
garbeam@59
|
106 .TP
|
|
arg@238
|
107 .B Mod1-Button2
|
|
arg@445
|
108 Zoom current window to the master column (tiling mode only).
|
|
arg@238
|
109 .TP
|
|
garbeam@59
|
110 .B Mod1-Button3
|
|
arg@445
|
111 Resize current window while dragging (floating mode only).
|
|
garbeam@82
|
112 .SH CUSTOMIZATION
|
|
arg@445
|
113 dwm is customized by creating a custom config.h and (re)compiling the source
|
|
arg@174
|
114 code. This keeps it fast, secure and simple.
|
|
arg@264
|
115 .SH CAVEATS
|
|
arg@347
|
116 The status bar may display
|
|
arg@445
|
117 .BR "broken pipe"
|
|
arg@445
|
118 when dwm has been started by
|
|
arg@264
|
119 .BR xdm (1),
|
|
arg@445
|
120 because it closes standard output before executing dwm.
|
|
arg@201
|
121 .SH SEE ALSO
|
|
arg@201
|
122 .BR dmenu (1)
|
