1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/dwm.1	Sun Mar 22 23:26:35 2009 -0700
     1.3 @@ -0,0 +1,149 @@
     1.4 +.TH DWM 1 dwm-VERSION
     1.5 +.SH NAME
     1.6 +dwm \- dynamic window manager
     1.7 +.SH SYNOPSIS
     1.8 +.B dwm
     1.9 +.RB [ \-v ]
    1.10 +.SH DESCRIPTION
    1.11 +dwm is a dynamic window manager for X. It manages windows in tiling and
    1.12 +versatile layouts. Either layout can be applied dynamically, optimizing the
    1.13 +environment for the application in use and the task performed.
    1.14 +.P
    1.15 +In tiling layout windows are managed in a master and stacking area. The master
    1.16 +area contains the windows which currently need most attention, whereas the
    1.17 +stacking area contains all other windows. In versatile layout windows can be
    1.18 +resized and moved freely. Dialog windows are always managed versatile,
    1.19 +regardless of the layout applied.
    1.20 +.P
    1.21 +Windows are grouped by tags. Each window can be tagged with one or multiple
    1.22 +tags. Selecting certain tags displays all windows with these tags.
    1.23 +.P
    1.24 +dwm contains a small status bar which displays all available tags, the layout,
    1.25 +the title of the focused window, and the text read from standard input. The
    1.26 +selected tags are indicated with a different color. The tags of the focused
    1.27 +window are indicated with a filled square in the top left corner.  The tags
    1.28 +which are applied to one or more windows are indicated with an empty square in
    1.29 +the top left corner.
    1.30 +.P
    1.31 +dwm draws a small border around windows to indicate the focus state.
    1.32 +.SH OPTIONS
    1.33 +.TP
    1.34 +.B \-v
    1.35 +prints version information to standard output, then exits.
    1.36 +.SH USAGE
    1.37 +.SS Status bar
    1.38 +.TP
    1.39 +.B Standard input
    1.40 +is read and displayed in the status text area.
    1.41 +.TP
    1.42 +.B Button1
    1.43 +click on a tag label to display all windows with that tag, click on the layout
    1.44 +label toggles between tiling and versatile layout.
    1.45 +.TP
    1.46 +.B Button3
    1.47 +click on a tag label adds/removes all windows with that tag to/from the view.
    1.48 +.TP
    1.49 +.B Button4
    1.50 +click on the layout label increases the number of windows in the master area (tiling layout only).
    1.51 +.TP
    1.52 +.B Button5
    1.53 +click on the layout label decreases the number of windows in the master area (tiling layout only).
    1.54 +.TP
    1.55 +.B Mod1-Button1
    1.56 +click on a tag label applies that tag to the focused window.
    1.57 +.TP
    1.58 +.B Mod1-Button3
    1.59 +click on a tag label adds/removes that tag to/from the focused window.
    1.60 +.SS Keyboard commands
    1.61 +.TP
    1.62 +.B Mod1-Shift-Return
    1.63 +Start
    1.64 +.BR xterm (1).
    1.65 +.TP
    1.66 +.B Mod1-Tab
    1.67 +Focus next window.
    1.68 +.TP
    1.69 +.B Mod1-Shift-Tab
    1.70 +Focus previous window.
    1.71 +.TP
    1.72 +.B Mod1-Return
    1.73 +Zooms/cycles current window to/from master area (tiling layout), toggles maximization of current window (versatile layout).
    1.74 +.TP
    1.75 +.B Mod1-g
    1.76 +Grow master area (tiling layout only).
    1.77 +.TP
    1.78 +.B Mod1-s
    1.79 +Shrink master area (tiling layout only).
    1.80 +.TP
    1.81 +.B Mod1-i
    1.82 +Increase the number of windows in the master area (tiling layout only).
    1.83 +.TP
    1.84 +.B Mod1-d
    1.85 +Decrease the number of windows in the master area (tiling layout only).
    1.86 +.TP
    1.87 +.B Mod1-Shift-[1..n]
    1.88 +Apply
    1.89 +.RB nth
    1.90 +tag to current window.
    1.91 +.TP
    1.92 +.B Mod1-Shift-0
    1.93 +Apply all tags to current window.
    1.94 +.TP
    1.95 +.B Mod1-Control-Shift-[1..n]
    1.96 +Add/remove
    1.97 +.B nth
    1.98 +tag to/from current window.
    1.99 +.TP
   1.100 +.B Mod1-Shift-c
   1.101 +Close focused window.
   1.102 +.TP
   1.103 +.B Mod1-space
   1.104 +Toggle between tiling and versatile layout (affects all windows).
   1.105 +.TP
   1.106 +.B Mod1-Shift-space
   1.107 +Toggle focused window between versatile and non-versatile state (tiling layout only).
   1.108 +.TP
   1.109 +.B Mod1-[1..n]
   1.110 +View all windows with
   1.111 +.BR nth
   1.112 +tag.
   1.113 +.TP
   1.114 +.B Mod1-0
   1.115 +View all windows with any tag.
   1.116 +.TP
   1.117 +.B Mod1-Control-[1..n]
   1.118 +Add/remove all windows with
   1.119 +.BR nth
   1.120 +tag to/from the view.
   1.121 +.TP
   1.122 +.B Mod1-Shift-q
   1.123 +Quit dwm.
   1.124 +.SS Mouse commands
   1.125 +.TP
   1.126 +.B Mod1-Button1
   1.127 +Move current window while dragging (versatile layout only).
   1.128 +.TP
   1.129 +.B Mod1-Button2
   1.130 +Zooms/cycles current window to/from master area (tiling layout), toggles maximization of current window (versatile layout).
   1.131 +.TP
   1.132 +.B Mod1-Button3
   1.133 +Resize current window while dragging (versatile layout only).
   1.134 +.SH CUSTOMIZATION
   1.135 +dwm is customized by creating a custom config.h and (re)compiling the source
   1.136 +code. This keeps it fast, secure and simple.
   1.137 +.SH SEE ALSO
   1.138 +.BR dmenu (1)
   1.139 +.SH BUGS
   1.140 +The status bar may display
   1.141 +.BR "EOF"
   1.142 +when dwm has been started by an X session manager like
   1.143 +.BR xdm (1),
   1.144 +because those close standard output before executing dwm.
   1.145 +.P
   1.146 +Java applications which use the XToolkit/XAWT backend may draw grey windows
   1.147 +only. The XToolkit/XAWT backend breaks ICCCM-compliance in recent JDK 1.5 and early
   1.148 +JDK 1.6 versions, because it assumes a reparenting window manager. As a workaround
   1.149 +you can use JDK 1.4 (which doesn't contain the XToolkit/XAWT backend) or you
   1.150 +can set the following environment variable (to use the older Motif
   1.151 +backend instead):
   1.152 +.BR AWT_TOOLKIT=MToolkit .