aewl
view dwm.1 @ 288:b7865e6feef2
applied sanders man page patch, removed button2 from bar click
| author | Anselm R.Garbe <arg@10ksloc.org> |
|---|---|
| date | Mon, 14 Aug 2006 18:14:08 +0200 |
| parents | dacd3f3c5823 |
| children | 093744cc5353 |
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 Button1
40 click on a tag label views all windows with that
41 .BR tag .
42 .TP
43 .B Button3
44 click on a tag label adds/removes all windows with that
45 .B tag
46 to/from the view.
47 .SS Keyboard commands
48 .TP
49 .B Mod1-Return
50 Zoom current
51 .B window
52 to the
53 .B master
54 column.
55 .TP
56 .B Mod1-j
57 Focus next
58 .BR window .
59 .TP
60 .B Mod1-k
61 Focus previous
62 .BR window .
63 .TP
64 .B Mod1-m
65 Maximize current
66 .BR window .
67 .TP
68 .B Mod1-[0..n]
69 View all windows with
70 .BR "tag n" .
71 .TP
72 .B Mod1-space
73 Toggle between
74 .B tiled
75 and
76 .B floating
77 mode (affects
78 .BR "all windows" ).
79 .TP
80 .B Mod1-Shift-[0..n]
81 Apply
82 .B nth tag
83 to current
84 .BR window .
85 .TP
86 .B Mod1-Shift-c
87 Close focused
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 .BR terminal .
97 .TP
98 .B Mod1-Control-[0..n]
99 Add/remove all windows with
100 .B tag n
101 to/from the view.
102 .TP
103 .B Mod1-Control-Shift-[0..n]
104 Add/remove
105 .B nth tag
106 to/from current
107 .BR window .
108 .SS Mouse commands
109 .TP
110 .B Mod1-Button1
111 Move current
112 .B window
113 while dragging.
114 .TP
115 .B Mod1-Button2
116 Zoom current
117 .B window
118 to the
119 .B master
120 column.
121 .TP
122 .B Mod1-Button3
123 Resize current
124 .B window
125 while dragging.
126 .SH CUSTOMIZATION
127 .B dwm
128 is customized by creating a custom config.h and (re)compiling the source
129 code. This keeps it fast, secure and simple.
130 .SH CAVEATS
131 The status bar displays
132 .B broken pipe
133 when
134 .B dwm
135 has been started by
136 .BR xdm (1),
137 because it closes standard output before executing
138 .BR dwm .
139 .SH SEE ALSO
140 .BR dmenu (1)