From: Jason Woofenden <jason@jasonwoof.com>
Date: Sun, 22 Apr 2012 19:58:41 +0000 (-0400)
Subject: rewrite cross-compile instructions to MXE method
X-Git-Tag: 0.5.6~4
X-Git-Url: https://jasonwoof.com/gitweb/?p=vor.git;a=commitdiff_plain;h=af493c1e4799e44c262357a9d34ca9f583466acd

rewrite cross-compile instructions to MXE method

and convert INSTALL file to markdown format
---

diff --git a/INSTALL b/INSTALL
index 13b219a..a7ea74b 100644
--- a/INSTALL
+++ b/INSTALL
@@ -1,81 +1,105 @@
-REQUIREMENTS
+Installation Instructions
+=========================
 
-	vor requires the following libraries to build/run:
-		sdl           http://www.libsdl.org/download-1.2.php
-		sdl_mixer     http://www.libsdl.org/projects/SDL_mixer/
-		sdl_image     http://www.libsdl.org/projects/SDL_image/
+Requirements
+------------
 
-	If you are building from git, (or editing the graphics) you will also
-	need:
+vor requires the following libraries to build/run:
 
-		povray        http://www.povray.org/
-		netpbm        http://netpbm.sourceforge.net/
-		autoconf      version 2.63 or greater
+*	sdl           http://www.libsdl.org/download-1.2.php
+*	sdl_mixer     http://www.libsdl.org/projects/SDL_mixer/
+*	sdl_image     http://www.libsdl.org/projects/SDL_image/
 
+If you are building from git, (or editing the graphics) you will also
+need:
 
-BUILDING A RELEASE
+	autoconf      version 2.63 or greater
 
-	(see BUILDING FROM GIT if you don't have a release tarball)
+You'll also need the graphics (`data` subdir) from the tarbal, or the following
+packages to render the graphics:
 
-	change to the source directory and run this:
+	povray        http://www.povray.org/
+	netpbm        http://netpbm.sourceforge.net/
 
-	./configure && make
 
-	Unless there are errors, you should be able to run the game from the
-	source directory like this:
+Building From A Release Tarball
+-------------------------------
 
-	./vor
+(See Building From Git below if you don't have a release tarball)
 
+change to the source directory and run this:
 
-BUILDING FROM GIT
+./configure && make
 
-	1) Make sure you have the extra dependencies first. If you want to avoid
+Unless there are errors, you should be able to run the game from the
+source directory like this:
+
+./vor
+
+
+Building From Git
+-----------------
+
+1.	Make sure you have the extra dependencies first. If you want to avoid
 	installing povray and/or netpbm, you can simply copy the data/ directory
 	from a recent release.
 
-	Run "autoconf".
+2.	Run "autoconf".
+
+3.	Continue as normal with the Building From A Release Tarball section above.
+
+
+Building For Windows
+--------------------
+
+These instructions should work on most any modern GNU/Linux system, and maybe
+other Unix-like systems.
+
+1.	Download MXE (and install its dependencies) by following just step 1 of
+	this tutorial:
 
-	Continue as normal with the BUILDING A RELEASE section above.
+	http://mxe.cc/#tutorial
+	
+2.	`cd` into the `mxe` directory
 
+3.	Run this: (takes some patience)
 
-BUILDING FOR WINDOWS
+		make gcc
 
-	Using mingw32 packages, you can use Linux to cross-compile a binary for
-	Windows. Below is the recommended way to achieve this:
+4.	Run this:
 
-	1) Install Fedora 11, and get up to date with "yum upgrade"
+		make sdl-image sdl-mixer
+	
+5.	Set up your environment for cross-compiling:
 
-	2) run as root: yum install mingw32-SDL_mixer mingw32-SDL_image
+		export PATH="/PATH/TO/YOUR/MXE/DIR/usr/bin:$PATH"
 
-	3) change to the VoR source directory
+6.	`cd` to vor source directory.
 
-	4) If you need to build the graphics (eg if you edited them, or if you're
-	not using a release tarball) then run: ./configure && make graphics
+7.	Build VoR with this command:
 
-	5) run: mingw32-configure && make
+		./configure --host=i686-pc-mingw32 && make
 
-	6) make a directory with vor.exe, data/ and the following files from
-	/usr/i686-pc-mingw32/sys-root/mingw/bin/: SDL.dll SDL_image.dll
-	SDL_mixer.dll libjpeg-62.dll libpng12-0.dll zlib1.dll
 
-	7) (optional) change to that directory, and test like so: wine ./vor.exe
+Running
+-------
 
-	8) zip up that new directory and try it out on a Windows install.
+	You can run VoR from the source directory without installing it:
 
+		./vor
 
-RUNNING
+	add `-h` to see commandline arguments.
 
-	"./vor"
+	See `README` file for keys, etc.
 
-	After building you should have an executable called "vor" in the
-	current (source) directory. You can run this here, "./vor"
 
-INSTALLING
+Installing
+----------
 
-	You can run "make install" to install vor. If you're installing
-	system-wide (for example, to the default install location of /usr/local)
+	You can run `make install` to install vor. If you're installing
+	system-wide (for example, to the default install location of `/usr/local`)
 	you'll need to run this as root.
 
-	You can specify an alternative install location with the --prefix=
-	argument to ./configure. See the output of: ./configure --help for more
+	You can specify an alternative install location with the `--prefix=`
+	argument to `./configure`. See the output of: `./configure --help` for more
 	information.