Abstract
--------
window manager improved 2 (wmii) [1] is an improved, modularized and
lightweight X11 window manager which supports tabbed, tiled and
conventional window management through layouts.
If it is build with cairo [2] support, it also provides
anti-aliased font rendering.
wmii consists of components that are independent processes and
communicate via a socket-based virtual filesystem which is oriented
on the "everything is file" paradigm of the plan9 [3] operating system.
The core distribution of wmii contains the window manager itself,
a master file system routing utility (wmifs), a generic bar (wmibar),
a shortcut handler (wmikeys), and a generic interaction menu (wmimenu)
beside several tiny utilities like wmir, wmiplumb, and wmiwarp.


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

Afterwards enter the following command to build and install wmii (if
necessary as root):

    $ make clean install

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

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

    $ cd libixp/python
    $ make clean install


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

    exec wmii

In order 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
    $ wmii

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 executable. 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 will fall back to CONFPREFIX/rc
which is 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 (dot) wegscheider (at) wegi (dot) net>
- Georg Neis <gn (at) oglaroon (dot) de> (shell script rework)
- Uwe Zeisberger <zeisberg (at) informatik (dot) uni-freiburg (dot) de>
- Uriel <uriell (at) binarydream (dot) org>
- Scot Doyle <scot (at) scotdoyle (dot) com>
- Sebastian Hartmann <seb (dot) wmi (at) gmx (dot) de>
- Bernhard Leiner <bleiner (at) gmail (dot) com>
- Jonas Domeij <jonas (dot) domeij (at) gmail (dot) com>
- Vincent <10 (dot) 50 (at) free (dot) fr>
- Oliver Kopp <olly (at) flupp (dot) de>
- Sebastian Roth <sebastian (dot) roth (at) gmail (dot) com>
- Steve Hoffman <steveh (at) g2switchworks (dot) com>
- Christof Musik <christof (at) senfdax (dot) de>

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

--Anselm R. Garbe
