JasonWoof Got questions, comments, patches, etc.? Contact Jason Woofenden
simplified man page
[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 It consists of a small status bar which reads the text displayed from standard
24 input, if written. It draws 1-pixel borders around windows to indicate the
25 focus state. Unfocused windows contain a small bar in front of the window
26 displaying the tags and the window title.
27 .SH OPTIONS
28 .TP
29 .B \-v
30 prints version information to standard output, then exits.
31 .SH USAGE
32 .TP
33 .B Mod1-Return
34 Zoom
35 .B window
36 to the 
37 .B master
38 column
39 .TP
40 .B Mod1-k
41 Focus previous
42 .B window
43 .TP
44 .B Mod1-j
45 Focus next
46 .B window
47 .TP
48 .B Mod1-m
49 Maximize current
50 .B window
51 .TP
52 .B Mod1-[0..n]
53 Focus
54 .B nth
55 tag
56 .TP
57 .B Mod1-space
58 (Re-)arrange
59 .B all
60 windows tiled
61 .TP
62 .B Mod1-Shift-space
63 (Re-)arrange
64 .B all
65 windows floating
66 .TP
67 .B Mod1-Shift-[0..n]
68 Apply
69 .B nth
70 tag to current
71 .B window
72 .TP
73 .B Mod1-Shift-q
74 Quit
75 .B dwm
76 .TP
77 .B Mod1-Shift-Return
78 Start
79 .B terminal
80 .TP
81 .B Mod1-Shift-w
82 Start
83 .B web browser
84 .TP
85 .B Mod1-Shift-l
86 Lock
87 .B screen
88 .TP
89 .B Control-[0..n]
90 Append
91 .B nth
92 tag to cureent
93 .B window
94 .TP
95 .B Control-Button1
96 Zooms the clicked
97 .B window
98 to master column
99 .TP
100 .B Mod1-Button1
101 Moves current
102 .B window
103 while dragging
104 .TP
105 .B Mod1-Button2
106 Lowers current
107 .B window
108 .TP
109 .B Mod1-Button3
110 Resizes current
111 .B window
112 while dragging
113 .SH CUSTOMIZATION
114 .B dwm
115 is customized through editing its source code.  This keeps it fast, secure and
116 simple. The source code contains the
117 .I CUSTOMIZE
118 keyword to highlight relevant portions for customization.