garbeam@0: gridwm
garbeam@0: ------
garbeam@0: 
garbeam@0: gridwm is an automatic X11 window manager which arranges all windows in a grid.
garbeam@9: One goal is not to exceed 3kSLOC.
garbeam@0: 
garbeam@0: 
garbeam@0: Requirements
garbeam@0: ------------
garbeam@0: In order to build gridwm you need the Xlib header files.
garbeam@0: 
garbeam@0: 
garbeam@0: Installation
garbeam@0: ------------
garbeam@0: Edit config.mk to match your local setup. gridwm is installed into
garbeam@0: the /usr/local namespace by default.
garbeam@0: 
garbeam@0: Afterwards enter the following command to build and install gridwm (if
garbeam@0: necessary as root):
garbeam@0: 
garbeam@0:     make clean install
garbeam@0: 
garbeam@0: 
garbeam@0: Running gridwm
garbeam@0: --------------
garbeam@0: Add the following line to your .xinitrc to start gridwm using startx:
garbeam@0: 
garbeam@0:     exec gridwm
garbeam@0: 
garbeam@0: In order to connect gridwm to a specific display, make sure that
garbeam@0: the DISPLAY environment variable is set correctly, e.g.:
garbeam@0: 
garbeam@0:     DISPLAY=foo.bar:1 exec wmii
garbeam@0: 
garbeam@0: This will start gridwm on display :1 of the host foo.bar.
garbeam@0: 
garbeam@0: 
garbeam@0: Configuration
garbeam@0: -------------
garbeam@0: The configuration of gridwm is done by customizing the config.h
garbeam@0: source file.