Updated build instructions for DOS, Windows, Linux.

Fixed targeting for Sandblast, Bone Shards, verified that targeting works okay
for all spells (woof).

Updated level layouts with more random features (David).

Made makefile.unix default to using flex instead of lex.

Tweaked beam names for dragon breath.

s/Paralyze/Paralyse/

Don't show current target for direction-only targeting.

git-svn-id: https://crawl-ref.svn.sourceforge.net/svnroot/crawl-ref/trunk@1222 c06c8d41-db1a-0410-9941-cceddc491573

1 files changed, 49 insertions, 19 deletions

diff --git a/crawl-ref/INSTALL b/crawl-ref/INSTALL
index e29e8a10d2..c962fd36c6 100644
--- a/crawl-ref/INSTALL
+++ b/crawl-ref/INSTALL
@@ -94,11 +94,11 @@ Building:
   packaged in a zip archive, it's safe to comment out SAVE_PACKAGE_CMD
   and LOAD_UNPACKAGE_CMD.
 
-* If you don't have flex or bison, edit makefile.unix and set DOYACC
-  := n. If you want to use byacc instead of bison, edit makefile.unix
-  and set YACC := byacc. On some Linuxes you may not have lex
-  symlinked to flex, in which case you'll have to set LEX := flex in
-  makefile.unix.
+* If you don't have (or don't want to use) flex or bison, edit
+  makefile.unix and set DOYACC := n. If you want to use byacc instead
+  of bison, edit makefile.unix and set YACC := byacc. On some Unixes,
+  you may not have flex (but have some other lex), in which case
+  you'll have to set LEX := lex in makefile.unix.
 
 * Run make to build the normal (non-wizard) Crawl. On systems such as
   Solaris, you may have to use gmake for GNU make. Make sure your make
@@ -113,7 +113,8 @@ Building:
 * If you have Lua, you can edit AppHdr.h and uncomment
         // #define CLUA_BINDINGS
   then add -llua to your LIB = line in makefile.unix, and rebuild to
-  compile with Lua support.
+  compile with Lua support. See the section on Lua (below) for more
+  information.
 
 
 Building on Mac OS X
@@ -154,15 +155,13 @@ Mac build instructions below.
   with Lua support.
 
 
-Building on Windows
--------------------
+Building on Windows (MinGW)
+---------------------------
 
-NOTE: Building for Windows+MinGW on Windows 9x/ME may work, but we've
-not tested it. You may be better off using the DOS build instructions
-if you're on 9x/ME.
-
-We've also not tested or updated the makefile for Borland C++. We
-strongly recommend using MinGW if possible.
+NOTE: You cannot build Windows binaries on Windows 9x/ME using the
+MinGW makefile supplied. If you're on 9x/ME, you can choose to use the
+Cygwin build instructions, or build a binary on a Windows NT/2k/XP
+system (the binary will run on 9x), or build a DOS binary.
 
 * Install MinGW from http://www.mingw.org. The MinGW 5.0.2 installer
   is best so you don't have to fiddle with individual packages (you
@@ -196,8 +195,24 @@ strongly recommend using MinGW if possible.
   subdirectory.
 
 
-Building on DOS
----------------
+Building on Windows (cygwin)
+----------------------------
+
+* Get Cygwin from http://www.cygwin.com/. When installing, ensure that
+  the following packages are selected: gcc, g++, make, flex, bison. If
+  you'd like to build from svn, install the svn client. You may also
+  want to install diff and patch if you'd like to apply third party
+  patches, or create your own.
+
+* Once Cygwin is installed, open a Cygwin bash shell (use the Start
+  menu, do not double-click bash.exe in Explorer). cd to the Crawl
+  source directory.
+
+* Follow the Linux build instructions to build Crawl.
+
+
+Building for DOS (djgpp)
+------------------------
 
 * Install djgpp from http://www.delorie.com/djgpp/. Don't forget to
   include C++ support when the Zip picker asks for what you want. You
@@ -272,13 +287,28 @@ This also depends on how you install Lua - some package management
 systems build just the plain old liblua.so even for pre 5.1 Lua. If in
 doubt, try both "-llua -llualib" and "-llua".
 
-On many Linuxes, the package management system installs Lua libraries
-including the version number, so the linker option becomes something
-like:
+On many Linuxes (Debian, for instance), the package management system
+installs Lua libraries including the version number, so the linker
+option becomes something like:
 
 LIB = -llua50
 
 
+Lua include path:
+
+On Unix, Lua headers may be installed in /usr/include (unlikely), or
+in a subdirectory of /usr/include (such as /usr/include/lua50/). If
+the headers are in a subdirectory, you need to add this directory to
+the include path in your makefile.unix:
+
+INCLUDES = -I/usr/include/ncurses -I/usr/include/lua50
+
+On other platforms, the Lua headers should usually be installed in
+your compiler's include directory, or a subdirectory. If it's in a
+subdirectory, you'll need to add the full directory path to your
+includes line.
+
+
 Getting Lua:
 
 On Unixes your package management system is the best way to get Lua.