about summary refs log tree commit diff stats
path: root/dwm.1
diff options
context:
space:
mode:
Diffstat (limited to 'dwm.1')
-rw-r--r--dwm.158
1 files changed, 54 insertions, 4 deletions
diff --git a/dwm.1 b/dwm.1
index 047299c..6ae2c39 100644
--- a/dwm.1
+++ b/dwm.1
@@ -7,14 +7,60 @@ dwm \- dynamic window manager
 .SH DESCRIPTION
 .SS Overview
 .B dwm
-is a dynamic window manager for X11.
+is a dynamic window manager for X11. It consists of a small status bar at the
+top of the screen and arranges windows in either a tiled or floating mode.
+.P
+If 
+.B dwm
+is in tiled mode, it consists of two columns. The left master column
+contains only one window per time, the right column contains all other windows 
+in a stack. In tiled mode
+.B dwm
+.B don't
+handles incremental resizals, some terminal programs like
+.B xterm
+may not work correctly with this in tiled mode.
+.P
+If
+.B dwm
+is in floating mode, it arranges all windows with the reqyested geometry and
+allows the user to move or resize them. Some windows, like
+dialog windows, are treated floating even if
+.B dwm
+is in tiled mode. In floating mode
+.B dwm
+handles incremental resizals.
+.P
+Windows are grouped by tags. You can view all windows with a specific tag per
+time.  However, each window is allowed to contain more than one tag, which
+allows to make windows visible in all views.
+.P
+.B dwm
+reads from
+.I stdin
+to display status text, if written.
+.P
+.B dwm
+draws 1-pixel borders around windows to indicate the focus state and save as
+much screen real estate as possible. Unfocused windows contain a small bar
+in front of the window indicating the tags and the window title.
 .SS Options
 .TP
 .B \-v
-prints version information to stdout, then exits.
-.SS Status text
+prints version information to
+.I stdout
+, then exits.
+.SS Customization
+.B dwm
+is customized through editing its source code. It is assumed that
+dwm users are high experienced users who know how a window manager works
+and who are able to patch
+.B dwm
+for their needs. This keeps
 .B dwm
-reads from stdin to display status text if provided.
+fast, secure and simple, because it does not process any input data, except
+window properties and the status text read from
+.I stdin .
 .SS Default Key Bindings
 .TP 16
 .I Key	
@@ -96,3 +142,7 @@ Lowers current
 Resizes current
 .B window
 while dragging
+.SH BUGS
+Some terminal programs do not behave correctly in tiled mode, because
+incremental resizals are ignored to use maximum screen real estate. You can
+patch the code to fix this.
n201'>201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298