JasonWoof Got questions, comments, patches, etc.? Contact Jason Woofenden
changed CFLAGs
[dwm.git] / dwm.1
1 .TH DWM 1 dwm-0.2
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, depending on the application in
11 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 needs most attention at a time, whereas the
15 stacking column contains all other windows in a stack.  Dialog windows are
16 managed floating, however. In floating mode windows can be resized and moved
17 freely.
18 .P
19 Windows are grouped by tags. All windows with a specific tag can be viewed at a
20 time. But each window may contain more than one tag, which makes it visible in
21 several views.
22 .P
23 .B dwm
24 consists of a small status bar which reads the text displayed from standard
25 input, if written. It draws 1-pixel borders around windows to indicate the
26 focus state. Unfocused windows contain a small bar in front of the window
27 displaying the tags and the window title.
28 .SH OPTIONS
29 .TP
30 .B \-v
31 prints version information to standard output, then exits.
32 .SH USAGE
33 .TP
34 .B Mod1-Return
35 Zoom
36 .B window
37 to the 
38 .B master
39 column
40 .TP
41 .B Mod1-k
42 Focus previous
43 .B window
44 .TP
45 .B Mod1-j
46 Focus next
47 .B window
48 .TP
49 .B Mod1-m
50 Maximize current
51 .B window
52 .TP
53 .B Mod1-[0..n]
54 Focus
55 .B nth
56 tag
57 .TP
58 .B Mod1-space
59 (Re-)arrange
60 .B all
61 windows tiled
62 .TP
63 .B Mod1-Shift-space
64 (Re-)arrange
65 .B all
66 windows floating
67 .TP
68 .B Mod1-Shift-[0..n]
69 Apply
70 .B nth
71 tag to current
72 .B window
73 .TP
74 .B Mod1-Shift-q
75 Quit
76 .B dwm
77 .TP
78 .B Mod1-Shift-Return
79 Start
80 .B terminal
81 .TP
82 .B Mod1-Shift-w
83 Start
84 .B web browser
85 .TP
86 .B Mod1-Shift-l
87 Lock
88 .B screen
89 .TP
90 .B Control-[0..n]
91 Append
92 .B nth
93 tag to current
94 .B window
95 .TP
96 .B Control-Shift-[0..n]
97 Replace current
98 .B window
99 of
100 .B nth
101 tag with current tag.
102 .B window
103 .TP
104 .B Control-Button1
105 Zooms the clicked
106 .B window
107 to master column
108 .TP
109 .B Mod1-Button1
110 Moves current
111 .B window
112 while dragging
113 .TP
114 .B Mod1-Button2
115 Lowers current
116 .B window
117 .TP
118 .B Mod1-Button3
119 Resizes current
120 .B window
121 while dragging
122 .SH CUSTOMIZATION
123 .B dwm
124 is customized through editing its source code.  This keeps it fast, secure and
125 simple. The source code contains the
126 .I CUSTOMIZE
127 keyword to highlight relevant portions for customization.