JasonWoof Got questions, comments, patches, etc.? Contact Jason Woofenden
added a trailing '.' to shortcut descriptions in 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 .TP
35 .B Mod1-Return
36 Zoom
37 .B window
38 to the 
39 .B master
40 column.
41 .TP
42 .B Mod1-h
43 Focus previous
44 .B tag.
45 .TP
46 .B Mod1-j
47 Focus next
48 .B window.
49 .TP
50 .B Mod1-k
51 Focus previous
52 .B window.
53 .TP
54 .B Mod1-l
55 Focus next
56 .B tag.
57 .TP
58 .B Mod1-m
59 Maximize current
60 .B window.
61 .TP
62 .B Mod1-[0..n]
63 Focus
64 .B nth tag.
65 .TP
66 .B Mod1-space
67 Toggle between
68 .B tiled
69 and
70 .B floating
71 mode (affects
72 .BR "all windows" ).
73 .TP
74 .B Mod1-Shift-[0..n]
75 Apply
76 .B nth tag
77 to current
78 .B window.
79 .TP
80 .B Mod1-Shift-q
81 Quit
82 .B dwm.
83 .TP
84 .B Mod1-Shift-Return
85 Start
86 .B terminal.
87 .TP
88 .B Mod1-Control-[0..n]
89 Append
90 .B nth tag
91 to current
92 .B window.
93 .TP
94 .B Mod1-Button1
95 Moves current
96 .B window
97 while dragging.
98 .TP
99 .B Mod1-Button2
100 Lowers current
101 .B window.
102 .TP
103 .B Mod1-Button3
104 Resizes current
105 .B window
106 while dragging.
107 .SH CUSTOMIZATION
108 .B dwm
109 is customized by creating a custom config.h and (re)compiling the source
110 code. This keeps it fast, secure and simple.
111 .SH SEE ALSO
112 .BR dmenu (1)