From e8c6cd983a488b452fa1b8355c38c5fa92e626a3 Mon Sep 17 00:00:00 2001
From: dshaligram <dshaligram@c06c8d41-db1a-0410-9941-cceddc491573>
Date: Tue, 26 Sep 2006 11:35:45 +0000
Subject: Updated INSTALL doc to include linking options and notes on the
 lua/lualib split in older Luas.

git-svn-id: https://crawl-ref.svn.sourceforge.net/svnroot/crawl-ref/branches/stone_soup@134 c06c8d41-db1a-0410-9941-cceddc491573
---
 crawl-ref/INSTALL | 28 +++++++++++++++++++++++-----
 1 file changed, 23 insertions(+), 5 deletions(-)

diff --git a/crawl-ref/INSTALL b/crawl-ref/INSTALL
index 879218e4dd..ca854c94a4 100644
--- a/crawl-ref/INSTALL
+++ b/crawl-ref/INSTALL
@@ -68,7 +68,8 @@ Building on Linux (or other Unixes)
 
 * If you have Lua, you can edit AppHdr.h and uncomment
         // #define CLUA_BINDINGS
-  before building.
+  then add -llua to your LIB = line in makefile.lnx, and rebuild to compile with
+  Lua support.
 
 
 Building on Mac OS X
@@ -109,9 +110,12 @@ recommend using MinGW if possible.
         // #define CLUA_BINDINGS
   and
         // #define REGEX_PCRE
-  before building to include Lua and regular-expression support. Note that
-  there are multiple // #define REGEX_PCRE lines in AppHdr.h - find the one in
-  the Windows-specific section.
+  Note that there are multiple // #define REGEX_PCRE lines in AppHdr.h - find
+  the one in the Windows-specific section.
+
+* Add -llua and -lpcre to the LIB line in makefile.mgw as:
+        LIB = -lwinmm -static -llua -lpcre
+  and build Crawl to include Lua and regex support.
 
 * When you're done, you should have crawl.exe under a "rel" subdirectory.
 
@@ -136,7 +140,9 @@ Building on DOS
         CFLAGS = -D$(OS_TYPE) $(EXTRA_FLAGS)
   to
         CFLAGS = -D$(OS_TYPE) $(EXTRA_FLAGS) -DCLUA_BINDINGS -DREGEX_PCRE
-  and build Crawl.
+  Add -llua and -lpcre to the LIB line in makefile.dos, like so:
+        LIB = -llua -lpcre
+  then build Crawl.
 
 * When the build is done, crawl.exe should be in the source directory.
 
@@ -146,6 +152,18 @@ Optional Libraries
 
 Lua
 ---
+NOTE: When linking in Lua, the makefile LIB line usually looks like this:
+
+LIB = -llua
+
+If you're using Lua older than 5.1, though, the Lua library comprises of *two*
+libraries: liblua and liblualib (yes, confusing), so you need
+
+LIB = -llua -llualib
+
+
+Getting Lua:
+
 On Unixes your package management system is the best way to get Lua. Make
 sure to install the development headers and not just the naked library.
 
-- 
cgit v1.2.3-54-g00ecf