1 files changed, 103 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..1580a73
--- /dev/null
+++ b/README.md
@@ -0,0 +1,103 @@
+##dminiwm
+### it's minimal and dynamic
+
+I started this from catwm 31/12/10 ( https://bbs.archlinux.org/viewtopic.php?id=100215&p=1 )
+    See dminiwm.c or config.h for thanks and licensing.
+Screenshots and ramblings/updates at https://bbs.archlinux.org/viewtopic.php?id=126463
+
+
+###Summary
+-------
+
+
+**dminiwm** is a very minimal and lightweight dynamic tiling window manager.
+    I will try to stay under 1000 SLOC.
+    Currently under 900 lines with the config file included.
+
+
+###Modes
+-----
+
+It allows the "normal" method of tiling window managers(with the new window as the master)
+    and with the new window opened at the bottom of the stack(like dwm's attach_aside)
+
+ *There's vertical tiling mode:*
+
+    --------------
+    |        | W |
+    |        |___|
+    | Master |   |
+    |        |___|
+    |        |   |
+    --------------
+
+ *Horizontal tiling mode:*
+
+    -------------
+    |           |
+    |  Master   |
+    |-----------|
+    | W |   |   |
+    -------------
+    
+ *Grid tiling mode:*
+
+    -------------
+    |      | W  |
+    |      |    |
+    |------|----|
+    |      |    |
+    -------------
+
+ *Fullscreen mode*(which you'll know when you see it)
+
+ All accessible with keyboard shortcuts defined in the config.h file.
+ 
+ * The window W at the top of the stack can be resized on a per desktop basis.
+ * Changing a tiling mode or window size on one desktop doesn't affect the other desktops.
+
+
+###Recent Changes
+--------------
+
+15/10/11
+ Added having applications open on specified desktop
+
+
+###Status
+------
+
+There are more options in the config file than the original catwm.
+
+  * Fixed the window manager crashing on a bad window error.
+  * Fixed the keyboard shortcuts not working if numlock was on.
+  * Added some functions.
+  * Added an option to focus the window the mouse just moved to.
+  * Fixed a window being destroyed on another desktop creating ghost windows.
+  * Added ability to resize the window on the top of the stack
+  * Added having applications open on specified desktop
+
+
+###Installation
+------------
+
+Need Xlib, then:
+
+    edit the config.h file to suit your needs
+
+    $ make
+    # make install
+    $ make clean
+
+
+###Bugs
+----
+
+[ * No bugs for the moment ;) (I mean, no importants bugs ;)]
+
+
+###Todo
+----
+
+  * when swithching desktops stop the mouse being in an unfocused window changing focus.
+