JasonWoof Got questions, comments, patches, etc.? Contact Jason Woofenden
patched dwm
[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-Button1
97 Zooms the clicked
98 .B window
99 to master column
100 .TP
101 .B Mod1-Button1
102 Moves current
103 .B window
104 while dragging
105 .TP
106 .B Mod1-Button2
107 Lowers current
108 .B window
109 .TP
110 .B Mod1-Button3
111 Resizes current
112 .B window
113 while dragging
114 .SH CUSTOMIZATION
115 .B dwm
116 is customized through editing its source code.  This keeps it fast, secure and
117 simple. The source code contains the
118 .I CUSTOMIZE
119 keyword to highlight relevant portions for customization.