1.1 --- a/dwm.1	Sat Jul 15 18:11:14 2006 +0200
     1.2 +++ b/dwm.1	Sat Jul 15 18:51:44 2006 +0200
     1.3 @@ -7,14 +7,60 @@
     1.4  .SH DESCRIPTION
     1.5  .SS Overview
     1.6  .B dwm
     1.7 -is a dynamic window manager for X11.
     1.8 +is a dynamic window manager for X11. It consists of a small status bar at the
     1.9 +top of the screen and arranges windows in either a tiled or floating mode.
    1.10 +.P
    1.11 +If 
    1.12 +.B dwm
    1.13 +is in tiled mode, it consists of two columns. The left master column
    1.14 +contains only one window per time, the right column contains all other windows 
    1.15 +in a stack. In tiled mode
    1.16 +.B dwm
    1.17 +.B don't
    1.18 +handles incremental resizals, some terminal programs like
    1.19 +.B xterm
    1.20 +may not work correctly with this in tiled mode.
    1.21 +.P
    1.22 +If
    1.23 +.B dwm
    1.24 +is in floating mode, it arranges all windows with the reqyested geometry and
    1.25 +allows the user to move or resize them. Some windows, like
    1.26 +dialog windows, are treated floating even if
    1.27 +.B dwm
    1.28 +is in tiled mode. In floating mode
    1.29 +.B dwm
    1.30 +handles incremental resizals.
    1.31 +.P
    1.32 +Windows are grouped by tags. You can view all windows with a specific tag per
    1.33 +time.  However, each window is allowed to contain more than one tag, which
    1.34 +allows to make windows visible in all views.
    1.35 +.P
    1.36 +.B dwm
    1.37 +reads from
    1.38 +.I stdin
    1.39 +to display status text, if written.
    1.40 +.P
    1.41 +.B dwm
    1.42 +draws 1-pixel borders around windows to indicate the focus state and save as
    1.43 +much screen real estate as possible. Unfocused windows contain a small bar
    1.44 +in front of the window indicating the tags and the window title.
    1.45  .SS Options
    1.46  .TP
    1.47  .B \-v
    1.48 -prints version information to stdout, then exits.
    1.49 -.SS Status text
    1.50 +prints version information to
    1.51 +.I stdout
    1.52 +, then exits.
    1.53 +.SS Customization
    1.54  .B dwm
    1.55 -reads from stdin to display status text if provided.
    1.56 +is customized through editing its source code. It is assumed that
    1.57 +dwm users are high experienced users who know how a window manager works
    1.58 +and who are able to patch
    1.59 +.B dwm
    1.60 +for their needs. This keeps
    1.61 +.B dwm
    1.62 +fast, secure and simple, because it does not process any input data, except
    1.63 +window properties and the status text read from
    1.64 +.I stdin .
    1.65  .SS Default Key Bindings
    1.66  .TP 16
    1.67  .I Key	
    1.68 @@ -96,3 +142,7 @@
    1.69  Resizes current
    1.70  .B window
    1.71  while dragging
    1.72 +.SH BUGS
    1.73 +Some terminal programs do not behave correctly in tiled mode, because
    1.74 +incremental resizals are ignored to use maximum screen real estate. You can
    1.75 +patch the code to fix this.