| 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
|
|
arg@504
|
12 In tiling mode windows are managed in a master and stacking area. The master
|
|
arg@504
|
13 area contains the window which currently needs most attention, whereas the
|
|
arg@504
|
14 stacking area 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@575
|
23 selected tags are indicated with a different color. The tags of the focused
|
|
arg@575
|
24 window are indicated with a small point in the top left corner. The tags which
|
|
arg@599
|
25 are applied to one or more clients are indicated with a pseudo-3d border.
|
|
arg@316
|
26 .P
|
|
arg@445
|
27 dwm draws a 1-pixel border around windows to indicate the focus state.
|
|
arg@342
|
28 Unfocused windows contain a small bar in front of them displaying their 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@288
|
39 .B Button1
|
|
arg@449
|
40 click on a tag label to display all windows with that tag, click on the mode
|
|
arg@525
|
41 label toggles between tiling and floating mode.
|
|
arg@262
|
42 .TP
|
|
arg@270
|
43 .B Button3
|
|
arg@530
|
44 click on a tag label adds/removes all windows with that tag to/from the view.
|
|
arg@398
|
45 .TP
|
|
arg@398
|
46 .B Mod1-Button1
|
|
arg@445
|
47 click on a tag label applies that tag to the focused window.
|
|
arg@398
|
48 .TP
|
|
arg@398
|
49 .B Mod1-Button3
|
|
arg@445
|
50 click on a tag label adds/removes that tag to/from the focused window.
|
|
arg@256
|
51 .SS Keyboard commands
|
|
garbeam@55
|
52 .TP
|
|
arg@293
|
53 .B Mod1-Shift-Return
|
|
arg@293
|
54 Start
|
|
arg@293
|
55 .BR xterm (1).
|
|
arg@293
|
56 .TP
|
|
arg@293
|
57 .B Mod1-Tab
|
|
arg@445
|
58 Focus next window.
|
|
arg@293
|
59 .TP
|
|
arg@293
|
60 .B Mod1-Shift-Tab
|
|
arg@445
|
61 Focus previous window.
|
|
arg@293
|
62 .TP
|
|
garbeam@55
|
63 .B Mod1-Return
|
|
arg@504
|
64 Zooms/cycles current window to/from master area (tiling mode), toggles maximization current window (floating mode).
|
|
arg@477
|
65 .TP
|
|
arg@415
|
66 .B Mod1-g
|
|
arg@558
|
67 Grow master area (tiling mode only).
|
|
arg@415
|
68 .TP
|
|
arg@421
|
69 .B Mod1-s
|
|
arg@558
|
70 Shrink master area (tiling mode only).
|
|
arg@421
|
71 .TP
|
|
arg@396
|
72 .B Mod1-Shift-[1..n]
|
|
arg@293
|
73 Apply
|
|
arg@445
|
74 .RB nth
|
|
arg@445
|
75 tag to current window.
|
|
arg@293
|
76 .TP
|
|
arg@594
|
77 .B Mod1-Shift-0
|
|
arg@594
|
78 Apply all tags to current window.
|
|
arg@594
|
79 .TP
|
|
arg@396
|
80 .B Mod1-Control-Shift-[1..n]
|
|
arg@293
|
81 Add/remove
|
|
arg@445
|
82 .B nth
|
|
arg@445
|
83 tag to/from current window.
|
|
arg@293
|
84 .TP
|
|
arg@293
|
85 .B Mod1-Shift-c
|
|
arg@445
|
86 Close focused window.
|
|
garbeam@55
|
87 .TP
|
|
garbeam@55
|
88 .B Mod1-space
|
|
arg@525
|
89 Toggle between tiling and floating mode (affects all windows).
|
|
garbeam@56
|
90 .TP
|
|
arg@585
|
91 .B Mod1-Shift-space
|
|
arg@592
|
92 Toggle focused window between floating and non-floating state (tiling mode only).
|
|
arg@585
|
93 .TP
|
|
arg@396
|
94 .B Mod1-[1..n]
|
|
arg@293
|
95 View all windows with
|
|
arg@445
|
96 .BR nth
|
|
arg@445
|
97 tag.
|
|
garbeam@56
|
98 .TP
|
|
arg@396
|
99 .B Mod1-0
|
|
arg@445
|
100 View all windows with any tag.
|
|
arg@395
|
101 .TP
|
|
arg@396
|
102 .B Mod1-Control-[1..n]
|
|
arg@288
|
103 Add/remove all windows with
|
|
arg@445
|
104 .BR nth
|
|
arg@445
|
105 tag to/from the view.
|
|
arg@264
|
106 .TP
|
|
arg@293
|
107 .B Mod1-Shift-q
|
|
arg@445
|
108 Quit dwm.
|
|
arg@256
|
109 .SS Mouse commands
|
|
garbeam@82
|
110 .TP
|
|
garbeam@59
|
111 .B Mod1-Button1
|
|
arg@445
|
112 Move current window while dragging (floating mode only).
|
|
garbeam@59
|
113 .TP
|
|
arg@238
|
114 .B Mod1-Button2
|
|
arg@504
|
115 Zoom current window to the master area (tiling mode only).
|
|
arg@238
|
116 .TP
|
|
garbeam@59
|
117 .B Mod1-Button3
|
|
arg@445
|
118 Resize current window while dragging (floating mode only).
|
|
garbeam@82
|
119 .SH CUSTOMIZATION
|
|
arg@445
|
120 dwm is customized by creating a custom config.h and (re)compiling the source
|
|
arg@174
|
121 code. This keeps it fast, secure and simple.
|
|
arg@264
|
122 .SH CAVEATS
|
|
arg@347
|
123 The status bar may display
|
|
arg@445
|
124 .BR "broken pipe"
|
|
arg@445
|
125 when dwm has been started by
|
|
arg@264
|
126 .BR xdm (1),
|
|
arg@445
|
127 because it closes standard output before executing dwm.
|
|
arg@201
|
128 .SH SEE ALSO
|
|
arg@201
|
129 .BR dmenu (1)
|
