JasonWoof Got questions, comments, patches, etc.? Contact Jason Woofenden
fixed dwm.1, added Mod1-Shift-c (was missing for an odd reason)
[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 Writing to standard input displays the text in the status text area.
37 .TP
38 .B Button[1-3]
39 click onto a tag label focuses the specifc tag.
40 .TP
41 .B Button[1,4]
42 click focuses the previous tag.
43 .TP
44 .B Button[2,5]
45 click focuses the next tag.
46 .SS Keyboard commands
47 .TP
48 .B Mod1-Return
49 Zoom current
50 .B window
51 to the 
52 .B master
53 column.
54 .TP
55 .B Mod1-h
56 Focus previous
57 .B tag.
58 .TP
59 .B Mod1-j
60 Focus next
61 .B window.
62 .TP
63 .B Mod1-k
64 Focus previous
65 .B window.
66 .TP
67 .B Mod1-l
68 Focus next
69 .B tag.
70 .TP
71 .B Mod1-m
72 Maximize current
73 .B window.
74 .TP
75 .B Mod1-[0..n]
76 Focus
77 .B nth tag.
78 .TP
79 .B Mod1-space
80 Toggle between
81 .B tiled
82 and
83 .B floating
84 mode (affects
85 .BR "all windows" ).
86 .TP
87 .B Mod1-Shift-[0..n]
88 Apply
89 .B nth tag
90 to current
91 .B window.
92 .TP
93 .B Mod1-Shift-c
94 Close focused
95 .B window.
96 .TP
97 .B Mod1-Shift-q
98 Quit
99 .B dwm.
100 .TP
101 .B Mod1-Shift-Return
102 Start
103 .B terminal.
104 .TP
105 .B Mod1-Control-[0..n]
106 Append
107 .B nth tag
108 to current
109 .B window.
110 .SS Mouse commands
111 .TP
112 .B Mod1-Button1
113 Move current
114 .B window
115 while dragging.
116 .TP
117 .B Mod1-Button2
118 Zoom current
119 .B window
120 to the 
121 .B master
122 column.
123 .TP
124 .B Mod1-Button3
125 Resize current
126 .B window
127 while dragging.
128 .SH CUSTOMIZATION
129 .B dwm
130 is customized by creating a custom config.h and (re)compiling the source
131 code. This keeps it fast, secure and simple.
132 .SH SEE ALSO
133 .BR dmenu (1)