JasonWoof Got questions, comments, patches, etc.? Contact Jason Woofenden
applied Sanders doc changes, added a PHONY line and changed the output of config...
[dwm.git] / dwm.1
1 .TH DWM 1 dwm-0.7
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.