dwm-meillo
view dwm.1 @ 264:afcea99a4f3f
updated man page, added CAVEATS section
| author | Anselm R.Garbe <arg@10ksloc.org> |
|---|---|
| date | Sun, 13 Aug 2006 18:04:42 +0200 |
| parents | d659a2dce2b5 |
| children | 8a8ea74e1b87 |
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,3]
40 click on a tag label focuses that
41 .B tag.
42 .TP
43 .B Button2
44 click on a tag label toggles that
45 .B tag.
46 .TP
47 .B Button[1,4]
48 click on the bar focuses the previous
49 .B tag.
50 .TP
51 .B Button[2,5]
52 click on the bar focuses the next
53 .B tag.
54 .SS Keyboard commands
55 .TP
56 .B Mod1-Return
57 Zoom current
58 .B window
59 to the
60 .B master
61 column.
62 .TP
63 .B Mod1-h
64 Focus previous
65 .B tag.
66 .TP
67 .B Mod1-j
68 Focus next
69 .B window.
70 .TP
71 .B Mod1-k
72 Focus previous
73 .B window.
74 .TP
75 .B Mod1-l
76 Focus next
77 .B tag.
78 .TP
79 .B Mod1-m
80 Maximize current
81 .B window.
82 .TP
83 .B Mod1-[0..n]
84 Focus
85 .B nth tag.
86 .TP
87 .B Mod1-space
88 Toggle between
89 .B tiled
90 and
91 .B floating
92 mode (affects
93 .BR "all windows" ).
94 .TP
95 .B Mod1-Shift-[0..n]
96 Apply
97 .B nth tag
98 to current
99 .B window.
100 .TP
101 .B Mod1-Shift-c
102 Close focused
103 .B window.
104 .TP
105 .B Mod1-Shift-q
106 Quit
107 .B dwm.
108 .TP
109 .B Mod1-Shift-Return
110 Start
111 .B terminal.
112 .TP
113 .B Mod1-Control-[0..n]
114 Toggle
115 .B nth tag.
116 .TP
117 .B Mod1-Control-Shift-[0..n]
118 Append
119 .B nth tag
120 to current
121 .B window.
122 .SS Mouse commands
123 .TP
124 .B Mod1-Button1
125 Move current
126 .B window
127 while dragging.
128 .TP
129 .B Mod1-Button2
130 Zoom current
131 .B window
132 to the
133 .B master
134 column.
135 .TP
136 .B Mod1-Button3
137 Resize current
138 .B window
139 while dragging.
140 .SH CUSTOMIZATION
141 .B dwm
142 is customized by creating a custom config.h and (re)compiling the source
143 code. This keeps it fast, secure and simple.
144 .SH CAVEATS
145 The status bar displays
146 .BR "broken pipe"
147 when
148 .B dwm
149 has been started by
150 .BR xdm (1),
151 because it closes standard output before executing
152 .B dwm.
153 .SH SEE ALSO
154 .BR dmenu (1)