aewl

view dwm.1 @ 286:ff501d94de62

fixed
author Anselm R.Garbe <arg@10ksloc.org>
date Mon, 14 Aug 2006 17:48:54 +0200
parents 8a8ea74e1b87
children b7865e6feef2
line source
1 .TH DWM 1 dwm-VERSION
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, optimizing the environment for
11 the application in 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 currently needs most attention, whereas the
15 stacking column contains all other windows. In floating mode windows can be
16 resized and moved freely. Dialog windows are always managed floating,
17 regardless of the mode selected.
18 .P
19 Windows are grouped by tags. Each window can be tagged with one or multiple
20 tags. Selecting a certain tag for viewing will display all windows with that
21 tag.
22 .P
23 .B dwm
24 has a small status bar which displays the text read from standard
25 input, if written. Besides that, it displays all available tags, and the title
26 of the focused window. It draws a 1-pixel border around windows to
27 indicate the focus state. Unfocused windows contain a small bar in front of
28 them displaying their tags and title.
29 .SH OPTIONS
30 .TP
31 .B \-v
32 prints version information to standard output, then exits.
33 .SH USAGE
34 .SS Status bar
35 .TP
36 .B Standard input
37 is read and displayed in the status text area.
38 .TP
39 .B Button[1,2]
40 click on a tag label focuses that
41 .B tag.
42 .TP
43 .B Button3
44 click on a tag label toggles that
45 .B tag.
46 .SS Keyboard commands
47 .TP
48 .B Mod1-Return
49 Zoom current
50 .B window
51 to the
52 .B master
53 column.
54 .TP
55 .B Mod1-j
56 Focus next
57 .B window.
58 .TP
59 .B Mod1-k
60 Focus previous
61 .B window.
62 .TP
63 .B Mod1-m
64 Maximize current
65 .B window.
66 .TP
67 .B Mod1-[0..n]
68 Focus
69 .B nth tag.
70 .TP
71 .B Mod1-space
72 Toggle between
73 .B tiled
74 and
75 .B floating
76 mode (affects
77 .BR "all windows" ).
78 .TP
79 .B Mod1-Shift-[0..n]
80 Apply
81 .B nth tag
82 to current
83 .B window.
84 .TP
85 .B Mod1-Shift-c
86 Close focused
87 .B window.
88 .TP
89 .B Mod1-Shift-q
90 Quit
91 .B dwm.
92 .TP
93 .B Mod1-Shift-Return
94 Start
95 .B terminal.
96 .TP
97 .B Mod1-Control-[0..n]
98 Toggle
99 .B nth tag.
100 .TP
101 .B Mod1-Control-Shift-[0..n]
102 Append
103 .B nth tag
104 to current
105 .B window.
106 .SS Mouse commands
107 .TP
108 .B Mod1-Button1
109 Move current
110 .B window
111 while dragging.
112 .TP
113 .B Mod1-Button2
114 Zoom current
115 .B window
116 to the
117 .B master
118 column.
119 .TP
120 .B Mod1-Button3
121 Resize current
122 .B window
123 while dragging.
124 .SH CUSTOMIZATION
125 .B dwm
126 is customized by creating a custom config.h and (re)compiling the source
127 code. This keeps it fast, secure and simple.
128 .SH CAVEATS
129 The status bar displays
130 .BR "broken pipe"
131 when
132 .B dwm
133 has been started by
134 .BR xdm (1),
135 because it closes standard output before executing
136 .B dwm.
137 .SH SEE ALSO
138 .BR dmenu (1)