several additions in mouse handling ;)

[dwm.git] / dwm.1

diff --git a/dwm.1 b/dwm.1
index 1c7a5a6..56dd8b9 100644 (file)
--- a/dwm.1
+++ b/dwm.1
@@ -1,18 +1,48 @@
-.TH DWM 1 dwm-0.0
+.TH DWM 1 dwm-0.1
 .SH NAME
 dwm \- dynamic window manager
 .SH SYNOPSIS
 .B dwm
 .RB [ \-v ]
 .SH DESCRIPTION
-.SS Overview
 .B dwm
-is a dynamic window manager for X11.
-.SS Options
+is a dynamic window manager for X11. It consists of a small status bar and
+arranges windows in either a tiled or floating mode.
+.P
+In tiled mode
+.B dwm
+manages all windows in a left master column and a right stacking column. The
+master column contains a single window, the left stacking column all other
+windows. Dialog windows are treated floating.
+.P
+In floating mode
+.B dwm
+manages all windows in a conventional way. They can be resized and moved freely
+with the mouse.
+.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 standard input to display status text, if written.
+.P
+.B dwm
+draws 1-pixel borders around windows to indicate the focus state and providing 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.
+.SH OPTIONS
 .TP
 .B \-v
-prints version information to stdout, then exits.
-.SS Default Key Bindings
+prints version information to standard output, then exits.
+.SH CUSTOMIZATION
+.B dwm
+is customized through editing its source code. It is assumed that
+.B dwm
+users know to patch it for their needs. This keeps it fast, secure and simple,
+because it does not process any input data, except window properties and
+the status text read from standard input.
+.SS Keyboard Control
 .TP 16
 .I Key 
 .I Action
@@ -22,7 +52,7 @@ Zoom
 .B window
 to the 
 .B master
-track
+column
 .TP
 .B Mod1-k
 Focus previous
@@ -45,3 +75,51 @@ tag
 (Re-)arrange
 .B all
 windows tiled
+.TP
+.B Mod1-Shift-space
+(Re-)arrange
+.B all
+windows floating
+.TP
+.B Mod1-Shift-[0..n]
+Apply
+.B nth
+tag to current
+.B window
+.TP
+.B Mod1-Shift-q
+Quit
+.B dwm
+.TP
+.B Mod1-Shift-Return
+Start
+.B terminal
+.TP
+.B Mod1-Shift-w
+Start
+.B web browser
+.TP
+.B Mod1-Shift-l
+Lock
+.B screen
+.TP
+.B Control-[0..n]
+Append
+.B nth
+tag to cureent
+.B window
+.SS Mouse Control
+.TP
+.B Mod1-Button1
+Moves current
+.B window
+while dragging
+.TP
+.B Mod1-Button2
+Lowers current
+.B window
+.TP
+.B Mod1-Button3
+Resizes current
+.B window
+while dragging