JasonWoof Got questions, comments, patches, etc.? Contact Jason Woofenden
fix keys pressed while kbspawn key is still down
[dwm.git] / README
diff --git a/README b/README
index 89f7dba..c38b3d3 100644 (file)
--- a/README
+++ b/README
@@ -1,6 +1,40 @@
-dwm - dynamic window manager
-----------------------------
-dwm is an extremly fast, small, and dynamic X11 window manager.
+JasonWoof's fork of dwm - dynamic window manager
+================================================
+dwm is an extremely fast, small, and dynamic window manager for X.
+
+JasonWoof's modifications include:
+
+1.     A new layout that's kinda like deck, but there's a little space above and
+       below the main slave window where you can see (a little bit of) the other
+       slave windows.
+
+2.     When you've got only 1 window in a workspace: by default, it is in the
+       master area. A new tag/attribute is used to specify windows that should use
+       all available space when alone. This results in fewer window resizes, and
+       is nice for applications which are usually not so nice when they're huge
+       (eg firefox, mutt).
+
+3.     _NET_WM_OPACITY is set. Run xcompmgr or the like, so you can see which
+       window has focus. (Non-zero width borders are probably broken in this fork)
+
+4.     Terminals are spawned with environmental variable containing the current
+       workspace number. This can be used to eg have separate shell history per
+       workspace, and/or make terminals stay in their correct workspaces accross
+       dwm restarts.
+
+5.     New windows open to the right (clockwise) of the focused window. Closing
+       the focused window focuses the window to its left (counter-clockwise). This
+       achieves both:
+       
+       1.      After closing a window, focus goes where you expect (it's consistent,
+               and you don't have to remember what was focused before to predict
+               correctly.)
+
+       2.      When you open a window, and then close it, focus goes back to where it
+               was originally.
+       
+       And an added bonus: The master window doesn't move around or change size
+       when you open or close other windows.
 
 
 Requirements
@@ -10,14 +44,17 @@ 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.
+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
 
+If you are going to use the default bluegray color scheme it is highly
+recommended to also install the bluegray files shipped in the dextra package.
+
 
 Running dwm
 -----------
@@ -30,21 +67,19 @@ 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.
-
+(This will start dwm on display :1 of the host foo.bar.)
 
-Displaying status info
-----------------------
-In order to display status info in the bar, you can do following
-in .xinitrc:
+In order to display status info in the bar, you can do something
+like this in your .xinitrc:
 
-    while true
+    while xsetroot -name "`date` `uptime | sed 's/.*,//'`"
     do
-        echo `date` `uptime | sed 's/.*://; s/,//g'`
-        sleep 2
-    done | dwm
+       sleep 1
+    done &
+    exec dwm
+
 
 Configuration
 -------------
-The configuration of dwm is done by customizing source code,
-grep for CUSTOMIZE keyword.
+The configuration of dwm is done by creating a custom config.h
+and (re)compiling the source code.