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