From dfe2d5a39007e86ccebf2e076ba53c99db49b95f Mon Sep 17 00:00:00 2001 From: Jason Woofenden Date: Thu, 25 Jun 2009 05:22:20 -0400 Subject: [PATCH] updated INSTALL for new build system --- INSTALL | 85 +++++++++++++++++++++++++++++++++++++++++---------------------- 1 file changed, 55 insertions(+), 30 deletions(-) diff --git a/INSTALL b/INSTALL index ec19922..6c408b4 100644 --- a/INSTALL +++ b/INSTALL @@ -4,53 +4,78 @@ REQUIREMENTS 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/ - And the following to create the graphics: + + If you are building from git, (or editing the graphics) you will also + need: + povray http://www.povray.org/ netpbm http://netpbm.sourceforge.net/ + autoconf version 2.63 or greater -BUILDING - - "cd" to the vor source directory and type "make" at the command prompt. - For the brave: see also BUILDING ON WINDOWS below +BUILDING A RELEASE -RUNNING + (see BUILDING FROM GIT if you don't have a release tarball) - "./vor" + change to the source directory and run this: - After building you should have an executable called "vor" in the - current (source) directory. You can run this here, "./vor" + ./configure && make -INSTALLING + 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 the data/ directory from a + recent release. + + Run "autoconf". - Just type "make install" at the command prompt. + Continue as normal with the BUILDING A RELEASE section above. - By default it puts the executable in /usr/games/bin and the data in - /usr/share/vor. If you'd like to change either, edit the Makefile - before building. If you change these settings in the Makefile after - building, you'll have to "make clean" and build again before - installing. +BUILDING FOR WINDOWS + Using mingw32 packages, you can use Linux to cross-compile a binary for + Windows. Below is the recommended way to achieve this: -BUILDING ON WINDOWS + 1) Install Fedora 11, and get up to date with "yum upgrade" - 1) Grab a copy of the vor source code with the images already rendered. If - you want to compile from the latest sources in the repository, you'll have - to check out onto a unix machine, and "make data" to render the ships and - rocks. The source tarballs usually have these rendered already. + 2) run as root: yum install mingw32-SDL_mixer mingw32-SDL_image - 2) download sdl source from libsdl.org. follow these instructions to - install msys, mingw, and sdl: + 3) change to the VoR source directory - http://www.libsdl.org/extras/win32/mingw32/README.txt + 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 - stay in the shell for step 3: + 5) run: mingw32-configure && make - 3) download, unpack and install sdl-mixer and sdl-image from source (should - (I hope) work the same way as installing sdl in step 2 above.) + 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 + + 8) zip up that new directory and try it out on a Windows install. + + +RUNNING + + "./vor" + + After building you should have an executable called "vor" in the + current (source) directory. You can run this here, "./vor" + +INSTALLING - http://www.libsdl.org/projects/SDL_mixer/index.html - http://www.libsdl.org/projects/SDL_image/index.html + 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. - 4) run this command in the vor source directory: mingw-make -f Makefile.win + You can specify an alternative install location with the --prefix= + argument to ./configure. See the output of: ./configure --help for more + information. -- 1.7.10.4