about summary refs log tree commit diff stats
path: root/README
diff options
context:
space:
mode:
Diffstat (limited to 'README')
-rw-r--r--README40
1 files changed, 40 insertions, 0 deletions
diff --git a/README b/README
new file mode 100644
index 0000000..c766f1b
--- /dev/null
+++ b/README
@@ -0,0 +1,40 @@
+gridwm
+------
+
+gridwm is an automatic X11 window manager which arranges all windows in a grid.
+
+
+Requirements
+------------
+In order to build gridwm you need the Xlib header files.
+
+
+Installation
+------------
+Edit config.mk to match your local setup. gridwm is installed into
+the /usr/local namespace by default.
+
+Afterwards enter the following command to build and install gridwm (if
+necessary as root):
+
+    make clean install
+
+
+Running gridwm
+--------------
+Add the following line to your .xinitrc to start gridwm using startx:
+
+    exec gridwm
+
+In order to connect gridwm to a specific display, make sure that
+the DISPLAY environment variable is set correctly, e.g.:
+
+    DISPLAY=foo.bar:1 exec wmii
+
+This will start gridwm on display :1 of the host foo.bar.
+
+
+Configuration
+-------------
+The configuration of gridwm is done by customizing the config.h
+source file.
href='#n136'>136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159