mirror of https://github.com/0intro/wmii
205 lines
3.3 KiB
Groff
205 lines
3.3 KiB
Groff
.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)
|