dwm-meillo
view dwm.1 @ 308:b591412bd2da
condition was insufficient
| author | Anselm R.Garbe <arg@10ksloc.org> |
|---|---|
| date | Wed, 16 Aug 2006 17:58:18 +0200 |
| parents | b7865e6feef2 |
| children | d69cdb180a3e |
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-Shift-Return
50 Start
51 .BR xterm (1).
52 .TP
53 .B Mod1-Tab
54 Focus next
55 .BR window .
56 .TP
57 .B Mod1-Shift-Tab
58 Focus previous
59 .BR window .
60 .TP
61 .B Mod1-Return
62 Zoom current
63 .B window
64 to the
65 .B master
66 column
67 .RB ( tiling
68 mode only).
69 .TP
70 .B Mod1-m
71 Maximize current
72 .BR window .
73 .TP
74 .B Mod1-Shift-[0..n]
75 Apply
76 .B nth tag
77 to current
78 .BR window .
79 .TP
80 .B Mod1-Control-Shift-[0..n]
81 Add/remove
82 .B nth tag
83 to/from current
84 .BR window .
85 .TP
86 .B Mod1-Shift-c
87 Close focused
88 .B window.
89 .TP
90 .B Mod1-space
91 Toggle between
92 .B tiled
93 and
94 .B floating
95 mode (affects
96 .BR "all windows" ).
97 .TP
98 .B Mod1-[0..n]
99 View all windows with
100 .BR "tag n" .
101 .TP
102 .B Mod1-Control-[0..n]
103 Add/remove all windows with
104 .B tag n
105 to/from the view.
106 .TP
107 .B Mod1-Shift-q
108 Quit
109 .B dwm.
110 .SS Mouse commands
111 .TP
112 .B Mod1-Button1
113 Move current
114 .B window
115 while dragging
116 .RB ( floating
117 mode only).
118 .TP
119 .B Mod1-Button2
120 Zoom current
121 .B window
122 to the
123 .B master
124 column
125 .RB ( tiling
126 mode only).
127 .TP
128 .B Mod1-Button3
129 Resize current
130 .B window
131 while dragging
132 .RB ( floating
133 mode only).
134 .SH CUSTOMIZATION
135 .B dwm
136 is customized by creating a custom config.h and (re)compiling the source
137 code. This keeps it fast, secure and simple.
138 .SH CAVEATS
139 The status bar displays
140 .B broken pipe
141 when
142 .B dwm
143 has been started by
144 .BR xdm (1),
145 because it closes standard output before executing
146 .BR dwm .
147 .SH SEE ALSO
148 .BR dmenu (1)