JasonWoof Got questions, comments, patches, etc.? Contact Jason Woofenden
centralized/externalized configuration to config.h
[dwm.git] / dwm.1
1 .TH DWM 1 dwm-0.5
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-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 Toggle between
60 .B tiled
61 and
62 .B floating
63 mode (affects
64 .BR "all windows" )
65 .TP
66 .B Mod1-Shift-[0..n]
67 Apply
68 .B nth
69 tag to current
70 .B window
71 .TP
72 .B Mod1-Shift-q
73 Quit
74 .B dwm
75 .TP
76 .B Mod1-Shift-Return
77 Start
78 .B terminal
79 .TP
80 .B Mod1-Control-[0..n]
81 Append
82 .B nth
83 tag to current
84 .B window
85 .TP
86 .B Mod1-Button1
87 Moves current
88 .B window
89 while dragging
90 .TP
91 .B Mod1-Button2
92 Lowers current
93 .B window
94 .TP
95 .B Mod1-Button3
96 Resizes current
97 .B window
98 while dragging
99 .SH CUSTOMIZATION
100 .B dwm
101 is customized through editing config.h of the source code.  This keeps it fast,
102 secure and simple.