JasonWoof Got questions, comments, patches, etc.? Contact Jason Woofenden
applied Sanders fixes to dwm.1
[dwm.git] / dwm.1
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 X11. 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 has a small status bar which displays the text read from standard
25 input, if written. Besides that, it displays all available tags, and the title
26 of the focused window. It draws a 1-pixel border around windows to
27 indicate the focus state. Unfocused windows contain a small bar in front of
28 them displaying their tags and title.
29 .SH OPTIONS
30 .TP
31 .B \-v
32 prints version information to standard output, then exits.
33 .SH USAGE
34 .SS Status bar
35 .TP
36 .B Standard input
37 is read and displayed in the status text area.
38 .TP
39 .B Button[1-3]
40 click on a tag label focuses that tag.
41 .TP
42 .B Button[1,4]
43 click on the bar focuses the previous tag.
44 .TP
45 .B Button[2,5]
46 click on the bar focuses the next tag.
47 .SS Keyboard commands
48 .TP
49 .B Mod1-Return
50 Zoom current
51 .B window
52 to the 
53 .B master
54 column.
55 .TP
56 .B Mod1-h
57 Focus previous
58 .B tag.
59 .TP
60 .B Mod1-j
61 Focus next
62 .B window.
63 .TP
64 .B Mod1-k
65 Focus previous
66 .B window.
67 .TP
68 .B Mod1-l
69 Focus next
70 .B tag.
71 .TP
72 .B Mod1-m
73 Maximize current
74 .B window.
75 .TP
76 .B Mod1-[0..n]
77 Focus
78 .B nth tag.
79 .TP
80 .B Mod1-space
81 Toggle between
82 .B tiled
83 and
84 .B floating
85 mode (affects
86 .BR "all windows" ).
87 .TP
88 .B Mod1-Shift-[0..n]
89 Apply
90 .B nth tag
91 to current
92 .B window.
93 .TP
94 .B Mod1-Shift-c
95 Close focused
96 .B window.
97 .TP
98 .B Mod1-Shift-q
99 Quit
100 .B dwm.
101 .TP
102 .B Mod1-Shift-Return
103 Start
104 .B terminal.
105 .TP
106 .B Mod1-Control-[0..n]
107 Append
108 .B nth tag
109 to current
110 .B window.
111 .SS Mouse commands
112 .TP
113 .B Mod1-Button1
114 Move current
115 .B window
116 while dragging.
117 .TP
118 .B Mod1-Button2
119 Zoom current
120 .B window
121 to the 
122 .B master
123 column.
124 .TP
125 .B Mod1-Button3
126 Resize current
127 .B window
128 while dragging.
129 .SH CUSTOMIZATION
130 .B dwm
131 is customized by creating a custom config.h and (re)compiling the source
132 code. This keeps it fast, secure and simple.
133 .SH SEE ALSO
134 .BR dmenu (1)