Abstract
--------
window manager improved 2 (wmii) is an improved, modularized and
lightweight X11 window manager which supports tabbed, tiled and
conventional window management.
If it is build with cairo [1] support, it also provides extended
rendering capabilities like alpha blending and UTF-8 capable
anti-aliased font rendering.
wmii consists of components which are independent processes which
communicate via a socket-based virtual filesystem, which is oriented on
the filesystem paradigm of the plan9 [2] operating system.
The core distribution of wmii contains the window manager itself, a
pager (wmipager), a generic status bar (wmibar), a shortcut handler
(wmikeys), and a generic ex-alike interaction menu (wmiinput) beside
several tiny utilities like wmir, wmiplumb, wmitw, and wmimulti.


Installation
------------
Edit config.mk to match your local setup. wmii is installed into
/usr/local by default.

Afterwards enter following command to build and install wmii:

    $ sudo make clean install

If you've pulled from darcs and make fails with an error about a missing
version.h, perform the following command:

    $ sudo make clean version install

If you want to build the python bindings for libixp, make sure you have
installed the pyrex [3] package.

Enter the following commands to build and install the python bindings:

    $ cd libixp/python
    $ sudo make clean install


Run wmii
--------
Add following line to your .xinitrc to start wmii using startx:

    exec wmii

To connect wmii or wmir to a specific display, make sure that DISPLAY
environment variable is set correctly, e.g.:

    $ setenv DISPLAY foo.bar:1
    $ startx

This will start wmii on display :1 of the host foo.bar if it is present
in your .xinitrc.


Configuration
-------------

wmii executes '$HOME/.wmii/rc start' on startup, if it exists and if it
is execuatble. See wmir(1) and wmii.rc(5) manual page for details about
the wmii configuration. On shutdown wmii executes '$HOME/.wmii/rc stop'
for cleanup reasons.

If $HOME/.wmii/rc is not present, wmii uses the CONFPREFIX/wmii/rc
script as fallback which will be installed automatically by default.
CONFPREFIX is set in config.mk and points to /usr/local/etc/wmii by
default.


Credits
-------

Beside all thanks to the wmi contributors, the following people have
contributed especially to wmii in various ways:

- Christoph Wegscheider <Christoph.Wegscheider at wegi dot net>
- Georg Neis <georg at f-451 dot net> (shell script rework)
- Uwe Zeisberger
- Uriel <uriell at binarydream dot org>
- Scot Doyle
- Sebastian Hartmann
- Bernhard Leiner
- Jonas Domeij <jonas.domeij@gmail.com>
- Vincent <10.50@free.fr>
- crypt
- Oliver Kopp <olly@flupp.de>

[1] http://cairographics.org
[2] http://www.cs.bell-labs.com/plan9dist/
[3] http://nz.cosc.canterbury.ac.nz/~greg/python/Pyrex/.

Get further information from: http://wmi.modprobe.de

--Anselm R. Garbe
