1Abstract
2--------
3window manager improved-improved is a dynamic window manager for X11.
4It supports classic and tiled window management with extended
5keyboard, mouse, and 9P-based [1] remote control.
6It consists of the wmiiwm(1) window manager and the wmiir(1)
7the remote access utility.
8
9
10Requirements
11------------
12In order to build wmii you need the Xlib header files and libixp. xmessage
13and dmenu are used by the default scripts. libixp and dmenu can be obtained
14from http://suckless.org/. Either plan9port[2] or 9base is recommended.
15
16
17Installation
18------------
19First, edit config.mk to match your local setup, or to let us guess it, run:
20	make config
21
22To build, simply run:
23	make
24
25To install, run the following, as root, if necessary:
26	make install
27
28Running wmii
29------------
30Add the following line to your .xinitrc to start wmii using startx:
31
32    until wmii; do
33	true
34    done
35
36In order to connect wmii to a specific display, make sure that
37the DISPLAY environment variable is set correctly. For example:
38
39    DISPLAY=:1 wmii
40
41This will start wmii on display :1.
42
43
44Configuration
45-------------
46The configuration of wmii is done by customizing the rc script rc.wmii.local,
47which remotely controls the window manager and handles various events.
48The main rc.wmii script lives in PREFIX/etc/wmii-3.5/, while rc.wmii.local
49goes in $HOME/.wmii-3.5/.
50
51rc.wmii.local should contain a line containing just: '# Overrides'. You must
52set your MODKEY and other configuration variables before this line, if you
53wish to change then, and define most functions after it.
54
55Credits
56-------
57The following people have contributed especially to wmii in various ways:
58
59- Christoph Wegscheider <christoph dot wegscheider at wegi dot net>
60- Georg Neis <gn at suckless dot org>
61- Uwe Zeisberger <zeisberg at informatik dot uni-freiburg dot de>
62- Uriel <uriel99 at gmail dot com>
63- Scot Doyle <scot at scotdoyle dot com>
64- Sebastian Hartmann <seb dot wmi at gmx dot de>
65- Bernhard Leiner <bleiner at gmail dot com>
66- Jonas Domeij <jonas dot domeij at gmail dot com>
67- Vincent <10 dot 50 at free dot fr>
68- Oliver Kopp <olly at flupp dot de>
69- Sebastian Roth <sebastian dot roth at gmail dot com>
70- Nico Golde <nico at ngolde dot de>
71- Steve Hoffman <steveh at g2switchworks dot com>
72- Christof Musik <christof at senfdax dot de>
73- Steffen Liebergeld <perl at gmx dot org>
74- Tobias Walkowiak <wal at ivu dot de>
75- Sander van Dijk <a dot h dot vandijk at gmail dot com>
76- Salvador Peiro <saoret dot one at gmail dot com>
77- Anthony Martin <ality at pbrane dot org>
78- Icarus Sparry <wmii at icarus dot freeuk dot com>
79- Norman Golisz <norman dot golisz at arcor dot de>
80- Stefano K. Lee <wizinblack at gmail dot com >
81- Stefan Tibus <sjti at gmx dot net>
82- Neptun <neptun at gmail dot com>
83- Daniel Wäber <_wabu at web dot de>
84
85
86References
87----------
88[1] http://9p.cat-v.org
89[2] http://plan9.us
90