aboutsummaryrefslogtreecommitdiff
path: root/README
diff options
context:
space:
mode:
authorarg@10ksloc.org2006-08-04 09:35:27 +0200
committerarg@10ksloc.org2006-08-04 09:35:27 +0200
commit7817523a685f0dbba2e074a448099558a54b1b9c (patch)
tree1bdeab046e27a18469750082e8dfdcaa3ce74db6 /README
initial import
Diffstat (limited to 'README')
-rw-r--r--README48
1 files changed, 48 insertions, 0 deletions
diff --git a/README b/README
new file mode 100644
index 0000000..5915a27
--- /dev/null
+++ b/README
@@ -0,0 +1,48 @@
+dwm - dynamic window manager
+----------------------------
+dwm is an extremely fast, small, and dynamic X11 window manager.
+
+
+Requirements
+------------
+In order to build dwm you need the Xlib header files.
+
+
+Installation
+------------
+Edit config.mk to match your local setup (dwm is installed into
+the /usr/local namespace by default).
+
+Afterwards enter the following command to build and install dwm (if
+necessary as root):
+
+ make clean install
+
+
+Running dwm
+-----------
+Add the following line to your .xinitrc to start dwm using startx:
+
+ exec dwm
+
+In order to connect dwm to a specific display, make sure that
+the DISPLAY environment variable is set correctly, e.g.:
+
+ DISPLAY=foo.bar:1 exec dwm
+
+(This will start dwm on display :1 of the host foo.bar.)
+
+In order to display status info in the bar, you can do something
+like this in your .xinitrc:
+
+ while true
+ do
+ echo `date` `uptime | sed 's/.*://; s/,//g'`
+ sleep 1
+ done | dwm
+
+
+Configuration
+-------------
+The configuration of dwm is done by creating a custom config.h
+and (re)compiling the source code.