.TH WMII 1 wmii-VERSION
.SH NAME
wmii \- window manager improved 2
.SH SYNOPSIS
.B wmii
.SH DESCRIPTION
.SS Overview
.B wmii
is a script that launches the wmii window manager and its various utilities and
makes sure that they are configured for use.
.SS Actions
An action is a shell script in the default setup, but it can actually be
any executable file.  It is executed usually by selecting it from the
actions menu.
You can customize an action by copying it from the global action
directory CONFPREFIX/wmii-CONFVERSION to $HOME/.wmii-CONFVERSION and then editing the copy to
fit your needs.  Of course you can also create your own actions there; make
sure that they are executable.
.P
Here is a list of the default actions:
.TP 2
quit
leave the window manager nicely
.TP 2
status
periodically print date and load average to the bar
.TP 2
welcome
display a welcome message that contains the wmii tutorial
.TP 2
wmiirc
configure wmii
.SS Default Key Bindings
.PD 0
.B Moving Around
.RS 2
.TP 16
.I Key	
.I Action
.TP
.B Mod-h
Move to a
.B window
to the 
.B left
of the one currently focused
.TP
.B Mod-l
Move to a
.B window
to the
.B right
of the one currently focused
.TP
.B Mod-j
Move to a
.B window below
the one currently focused
.TP
.B Mod-k
Move to a
.B window above
the one currently focused
.TP
.B Mod-space
.B Toggle
between the managed and floating
.B layer
.TP
.BI Mod-t \ tag
Move to the
.B view
of the given
.I tag
.TP
.B Mod-[0-9]
Move to the
.B view
with the given number
.PD 1
.P
.RE
.B Moving Things Around
.RS 2
.PD 0
.TP 16
.I Key
.I Action
.TP
.B Mod-Shift-h
Move the current window
.B window
to a column on the
.B left
.TP
.B Mod-Shift-l
Move the current window
.B window
to a column on the
.B right
.TP
.B Mod-Shift-j
Move the current
.B window below
the one beneath it
.TP
.B Mod-Shift-k
Move the current
.B window above
the one above it
.TP
.B Mod-Shift-space
.B Toggle
the current
.B window
between the managed and floating
.B layer
.TP
.BI Mod-Shift-t \ tag
Move the current window to the
.B view
of the given
.I tag
.TP
.B Mod-Shift-[0-9]
Move to the current window to the
.B view
with the given number
.PD 1
.P
.RE
.B Miscellaneous
.RS 2
.PD 0
.TP 16
.I Key
.I Action
.TP
.B Mod-m
Switch the current column to
.B max mode
.TP
.B Mod-s
Switch the current column to
.B stack mode
.TP
.B Mod-d
Switch the current column to
.B default mode
.TP
.B Mod-Shift-c
.B Kill
the selected client
.TP
.BI Mod-p \ program
.B Execute
.I program
.TP
.BI Mod-a \ action
Execute the
.B named action
.TP
.B Mod-Enter
Start an
.B xterm

.SS Configuration
If you feel the need to change the default configuration, then customize (as
described above) the
.B wmiirc
action.  This action is executed at the end of the
.B wmii
script and does all the work of setting up the window manager, the key
bindings, the bar labels, etc.
.SH FILES
.TP
/tmp/ns.$USER.${DISPLAY%.0}/wmii
The wmii socket file which provides a 9P service.
.TP
CONFPREFIX/wmii-CONFVERSION
Global action directory.
.TP
$HOME/.wmii-CONFVERSION
User-specific action directory.  Actions are first searched here.
.SH ENVIRONMENT
.TP
HOME, DISPLAY
See the section
.B FILES
above.
.P
The following variables are set and exported within
.B wmii
and thus can be used in actions:
.TP
WMII_ADDRESS
Socket file of
.BR wmiiwm (1).
Used by
.BR wmiir (1).
.SH SEE ALSO
.BR wmiiwm (1),
.BR dmenu (1),
.BR wmiir (1)