JasonWoof Got questions, comments, patches, etc.? Contact Jason Woofenden
several additions in mouse handling ;)
[dwm.git] / dwm.1
1 .TH DWM 1 dwm-0.1
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 consists of a small status bar and
10 arranges windows in either a tiled or floating mode.
11 .P
12 In tiled mode
13 .B dwm
14 manages all windows in a left master column and a right stacking column. The
15 master column contains a single window, the left stacking column all other
16 windows. Dialog windows are treated floating.
17 .P
18 In floating mode
19 .B dwm
20 manages all windows in a conventional way. They can be resized and moved freely
21 with the mouse.
22 .P
23 Windows are grouped by tags. You can view all windows with a specific tag per
24 time.  However, each window is allowed to contain more than one tag, which
25 allows to make windows visible in all views.
26 .P
27 .B dwm
28 reads from standard input to display status text, if written.
29 .P
30 .B dwm
31 draws 1-pixel borders around windows to indicate the focus state and providing as
32 much screen real estate as possible. Unfocused windows contain a small bar
33 in front of the window indicating the tags and the window title.
34 .SH OPTIONS
35 .TP
36 .B \-v
37 prints version information to standard output, then exits.
38 .SH CUSTOMIZATION
39 .B dwm
40 is customized through editing its source code. It is assumed that
41 .B dwm
42 users know to patch it for their needs. This keeps it fast, secure and simple,
43 because it does not process any input data, except window properties and
44 the status text read from standard input.
45 .SS Keyboard Control
46 .TP 16
47 .I Key  
48 .I Action
49 .TP
50 .B Mod1-Return
51 Zoom
52 .B window
53 to the 
54 .B master
55 column
56 .TP
57 .B Mod1-k
58 Focus previous
59 .B window
60 .TP
61 .B Mod1-j
62 Focus next
63 .B window
64 .TP
65 .B Mod1-m
66 Maximize current
67 .B window
68 .TP
69 .B Mod1-[0..n]
70 Focus
71 .B nth
72 tag
73 .TP
74 .B Mod1-space
75 (Re-)arrange
76 .B all
77 windows tiled
78 .TP
79 .B Mod1-Shift-space
80 (Re-)arrange
81 .B all
82 windows floating
83 .TP
84 .B Mod1-Shift-[0..n]
85 Apply
86 .B nth
87 tag to current
88 .B window
89 .TP
90 .B Mod1-Shift-q
91 Quit
92 .B dwm
93 .TP
94 .B Mod1-Shift-Return
95 Start
96 .B terminal
97 .TP
98 .B Mod1-Shift-w
99 Start
100 .B web browser
101 .TP
102 .B Mod1-Shift-l
103 Lock
104 .B screen
105 .TP
106 .B Control-[0..n]
107 Append
108 .B nth
109 tag to cureent
110 .B window
111 .SS Mouse Control
112 .TP
113 .B Mod1-Button1
114 Moves current
115 .B window
116 while dragging
117 .TP
118 .B Mod1-Button2
119 Lowers current
120 .B window
121 .TP
122 .B Mod1-Button3
123 Resizes current
124 .B window
125 while dragging