aewl

annotate README @ 17:aaf520f53110

updated README
author Anselm R. Garbe <garbeam@wmii.de>
date Tue, 11 Jul 2006 18:59:09 +0200
parents d567f430a81d
children 1efa34c6e1b6
rev   line source
garbeam@0 1 gridwm
garbeam@0 2 ------
garbeam@0 3
garbeam@17 4 gridwm is an extremly fast, small, and automatic X11 window manager. It
garbeam@17 5 arranges all windows in a grid.
garbeam@17 6
garbeam@17 7
garbeam@17 8 Configuration
garbeam@17 9 -------------
garbeam@17 10 You have to edit the source code for configuration, this WM is intended to
garbeam@17 11 provide sane defaults, if something doesn't fits your needs, edit config.h and
garbeam@17 12 maybe key.c. To change the status output edit that status variable definition
garbeam@17 13 in wm.c.
garbeam@0 14
garbeam@0 15
garbeam@0 16 Requirements
garbeam@0 17 ------------
garbeam@0 18 In order to build gridwm you need the Xlib header files.
garbeam@0 19
garbeam@0 20
garbeam@0 21 Installation
garbeam@0 22 ------------
garbeam@0 23 Edit config.mk to match your local setup. gridwm is installed into
garbeam@0 24 the /usr/local namespace by default.
garbeam@0 25
garbeam@0 26 Afterwards enter the following command to build and install gridwm (if
garbeam@0 27 necessary as root):
garbeam@0 28
garbeam@0 29 make clean install
garbeam@0 30
garbeam@0 31
garbeam@0 32 Running gridwm
garbeam@0 33 --------------
garbeam@0 34 Add the following line to your .xinitrc to start gridwm using startx:
garbeam@0 35
garbeam@0 36 exec gridwm
garbeam@0 37
garbeam@0 38 In order to connect gridwm to a specific display, make sure that
garbeam@0 39 the DISPLAY environment variable is set correctly, e.g.:
garbeam@0 40
garbeam@17 41 DISPLAY=foo.bar:1 exec gridwm
garbeam@0 42
garbeam@0 43 This will start gridwm on display :1 of the host foo.bar.
garbeam@0 44
garbeam@0 45
garbeam@0 46 Configuration
garbeam@0 47 -------------
garbeam@17 48 The configuration of gridwm is done by customizing the config.h source file. To
garbeam@17 49 customize the key bindings edit key.c. To change the status output, edit the
garbeam@17 50 status command definition in wm.c.
garbeam@17 51