aboutsummaryrefslogtreecommitdiff
path: root/README
diff options
context:
space:
mode:
authorBradley Taunt <bt@btxx.org>2024-01-18 12:45:24 -0500
committerBradley Taunt <bt@btxx.org>2024-01-18 12:45:24 -0500
commitaa0a43277b7b26fdd5f80e4e0a28142d6a93068c (patch)
tree6608af9ed0c4cef055b5d0c190dd2acf2e2ac955 /README
Initial commit on the self-hosted cgit platform
Diffstat (limited to 'README')
-rwxr-xr-xREADME48
1 files changed, 48 insertions, 0 deletions
diff --git a/README b/README
new file mode 100755
index 0000000..95d4fd0
--- /dev/null
+++ b/README
@@ -0,0 +1,48 @@
+dwm - dynamic window manager
+============================
+dwm is an extremely fast, small, and dynamic window manager for X.
+
+
+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 xsetroot -name "`date` `uptime | sed 's/.*,//'`"
+ do
+ sleep 1
+ done &
+ exec dwm
+
+
+Configuration
+-------------
+The configuration of dwm is done by creating a custom config.h
+and (re)compiling the source code.