wmii/cmd/wm/wmii.1
2006-03-08 14:22:42 +01:00

98 lines
2.2 KiB
Groff

.TH WMII 1 wmii-3
.SH NAME
wmii \- window manager improved 2
.SH SYNOPSIS
.B wmii
.SH DESCRIPTION
.SS Overview
.BR wmii (1)
is a script that launches the
.B wmii
window manager and its various utilities and takes care that they are
configured for use.
.SS Actions
An action is a script written for the rc shell, 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-3 to $HOME/.wmii-3 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
extern <cmd>
clean the environment and execute the given command
.TP 2
kmode <mode>
activate shortcuts of the given mode
.TP 2
quit
quit wmii
.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 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
.BR wmii (1)
script and does all the work of setting up the window manager, the key
bindings, the bar labels, etc.
.SH FILES
.TP
/tmp/.ixp-$USER
Directory where the socket files are stored.
.TP
CONFPREFIX/wmii-3
Global action directory.
.TP
$HOME/.wmii-3
User-specific action directory. Actions are first searched here.
.SH ENVIRONMENT
.TP
HOME, USER
See the section
.B FILES
above.
.P
The following variables are set and exported within
.BR wmii (1)
and thus can be used in actions.
.TP
old_path
path as it was before
.BR wmii (1)
added the local and global action directory and the location where the 9base
tools reside. The
.B wmiire
action resets path and removes old_path before executing a command.
.TP
WMII_CONFDIR
Global action directory.
.TP
WMII_IDENT
Unique identifier for the
.BR wmii (1)
session. Part of the socket file names.
.TP
WMIIR_SOCKET
Socket file of
.BR wmiifs (1).
Used by
.BR wmiir (1).
.SH SEE ALSO
.BR wmiibar (1),
.BR wmiifs (1),
.BR wmiiwm (1),
.BR wmiikeys (1),
.BR wmiimenu (1),
.BR wmiir (1)