X-Git-Url: https://jasonwoof.com/gitweb/?a=blobdiff_plain;f=dwm.1;h=4e23f1cb764960327aa58c504805d8f1a6eee038;hb=2dd5212a795b27422d601df0566ae0d6644bd4c8;hp=191ffc034975ef30fdcec79f9c96dbbb764a3830;hpb=5ef6ef1bacff6bae72ba2226d8b89be2dfb6d3b5;p=dwm.git

diff --git a/dwm.1 b/dwm.1
index 191ffc0..4e23f1c 100644
--- a/dwm.1
+++ b/dwm.1
@@ -1,4 +1,4 @@
-.TH DWM 1 dwm-0.7
+.TH DWM 1 dwm-VERSION
 .SH NAME
 dwm \- dynamic window manager
 .SH SYNOPSIS
@@ -6,7 +6,7 @@ dwm \- dynamic window manager
 .RB [ \-v ]
 .SH DESCRIPTION
 .B dwm
-is a dynamic window manager for X11. It manages windows in tiling and floating
+is a dynamic window manager for X. It manages windows in tiling and floating
 modes. Either mode can be applied dynamically, optimizing the environment for
 the application in use and the task performed.
 .P
@@ -21,47 +21,78 @@ tags. Selecting a certain tag for viewing will display all windows with that
 tag.
 .P
 .B dwm
-has a small status bar which displays the text read from standard
-input, if written. Besides that, it displays all available tags, and the title
-of the focused window. It draws a 1-pixel border around windows to
-indicate the focus state. Unfocused windows contain a small bar in front of
-them displaying their tags and title.
+contains a small status bar which displays all available tags, the mode, the
+title of the focused window, and the text read from standard input. The tags of
+the focused window are highlighted with a small point.
+.P
+.B dwm
+draws a 1-pixel border around windows to indicate the focus state.
+Unfocused windows contain a small bar in front of them displaying their title.
 .SH OPTIONS
 .TP
 .B \-v
 prints version information to standard output, then exits.
 .SH USAGE
+.SS Status bar
 .TP
-.B Mod1-Return
-Zoom
-.B window
-to the 
-.B master
-column
+.B Standard input
+is read and displayed in the status text area.
 .TP
-.B Mod1-h
-Focus previous
+.B Button1
+click on a tag label views all windows with that
+.BR tag ,
+click on the mode label toggles between
+.B tiled
+and
+.B floating
+mode.
+.TP
+.B Button3
+click on a tag label adds/removes all windows with that
 .B tag
+to/from the view.
+.SS Keyboard commands
 .TP
-.B Mod1-j
+.B Mod1-Shift-Return
+Start
+.BR xterm (1).
+.TP
+.B Mod1-Tab
 Focus next
-.B window
+.BR window .
 .TP
-.B Mod1-k
+.B Mod1-Shift-Tab
 Focus previous
-.B window
+.BR window .
 .TP
-.B Mod1-l
-Focus next
-.B tag
+.B Mod1-Return
+Zoom current
+.B window
+to the 
+.B master
+column
+.RB ( tiling
+mode only).
 .TP
 .B Mod1-m
 Maximize current
-.B window
+.BR window .
 .TP
-.B Mod1-[0..n]
-Focus
+.B Mod1-Shift-[0..n]
+Apply
+.B nth tag
+to current
+.BR window .
+.TP
+.B Mod1-Control-Shift-[0..n]
+Add/remove
 .B nth tag
+to/from current
+.BR window .
+.TP
+.B Mod1-Shift-c
+Close focused
+.B window.
 .TP
 .B Mod1-space
 Toggle between
@@ -69,44 +100,56 @@ Toggle between
 and
 .B floating
 mode (affects
-.BR "all windows" )
+.BR "all windows" ).
 .TP
-.B Mod1-Shift-[0..n]
-Apply
-.B nth tag
-to current
-.B window
+.B Mod1-[0..n]
+View all windows with
+.BR "tag n" .
+.TP
+.B Mod1-Control-[0..n]
+Add/remove all windows with
+.B tag n
+to/from the view.
 .TP
 .B Mod1-Shift-q
 Quit
-.B dwm
-.TP
-.B Mod1-Shift-Return
-Start
-.B terminal
-.TP
-.B Mod1-Control-[0..n]
-Append
-.B nth tag
-to current
-.B window
+.B dwm.
+.SS Mouse commands
 .TP
 .B Mod1-Button1
-Moves current
+Move current
 .B window
 while dragging
+.RB ( floating
+mode only).
 .TP
 .B Mod1-Button2
-Lowers current
+Zoom current
 .B window
+to the 
+.B master
+column
+.RB ( tiling
+mode only).
 .TP
 .B Mod1-Button3
-Resizes current
+Resize current
 .B window
 while dragging
+.RB ( floating
+mode only).
 .SH CUSTOMIZATION
 .B dwm
 is customized by creating a custom config.h and (re)compiling the source
 code. This keeps it fast, secure and simple.
+.SH CAVEATS
+The status bar may display
+.B broken pipe
+when
+.B dwm
+has been started by
+.BR xdm (1),
+because it closes standard output before executing
+.BR dwm .
 .SH SEE ALSO
 .BR dmenu (1)