Added README

3 files changed, 68 insertions, 2 deletions

diff --git a/README b/README
new file mode 100644
index 0000000..14a47d7
--- /dev/null
+++ b/README
@@ -0,0 +1,66 @@
+BUILDING
+--------
+To build just run 'make'. 
+
+
+DESCRIPTION
+-----------
+
+dbox is a simple brute-force Sokoban level solver.  Usage is:
+
+dbox [-v|-i|-p|-P] file [file2 ...]
+
+-v	- Be verbose.  Print depth of search tree as searching is done.
+-i	- Interactive.  Show an interactive version of the map once solved.
+-P\-p	- Play.  Allows you to play the level.
+
+The file is a Sokoban level defined like this:
+
+
+Level 1
+  ###   
+  #.#   
+  # ####
+###B B.#
+#. B@###
+####B#  
+   #.#  
+   ###  
+
+The first line is the title of the level.
+
+The subsequent lines must all be of the same width and define the level.  The
+'#' character defines a wall.  The 'B' character defines a box.  The '.'
+character defines a target square.  The 'X' character can be used to define a
+box already on a target square.
+
+If no interactive mode is used the level will be displayed along with the
+route to solve it, e.g.
+
+Solving Level 1
+
+  ###   
+  #.#   
+  # ####
+###B B.#
+#. B@###
+####B#  
+   #.#  
+   ###  
+
+Route = 'DULLRUUDRR'
+
+
+INTERACTIVE MODE KEYS
+---------------------
+
+In interactive mode the following keys can be used.
+
+P		- Follow the solution path if one was found.
+Backspace/B	- Step back one move on the solution path.
+Cursor Keys	- Move.  Note that the move will be blocked if the state of the
+		  map is already known or moving a block will make the level
+		  insoluble.
+Q		- Quit.
+
+Cursors to move, P to follow path, Q to quit, Backspace/B to step back
diff --git a/dbox.c b/dbox.c
index aadacb7..638f615 100644
--- a/dbox.c
+++ b/dbox.c
@@ -1,7 +1,7 @@
 /*
     dbox - Sokoban level solver
 
-    Copyright (C) 2001-2009  Ian Cowburn (ianc@noddybox.demon.co.uk)
+    Copyright (C) 2001-2009  Ian Cowburn (ianc@noddybox.co.uk)
 
     This program is free software; you can redistribute it and/or modify
     it under the terms of the GNU General Public License as published by
diff --git a/mktar b/mktar
index b0232f2..fb21e03 100644
--- a/mktar
+++ b/mktar
@@ -3,7 +3,7 @@
 FILE=dbox.tar.gz
 
 make clean
-tar cvfz $FILE level* sok* net* Makefile mktar *.c
+tar cvfz $FILE level* sok* net* Makefile mktar *.c README
 
 if [ `uname` != "Linux" ] ;
 then