171 lines
6.8 KiB
HTML
171 lines
6.8 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
|
|
<html>
|
|
<head>
|
|
<title>Warzone Compilation Guide</title>
|
|
<meta name="author" content="Christian Vest Hansen">
|
|
<meta name="Reply-to" content="karmazilla@gmail.com">
|
|
<meta name="Copyright" content="GNU Documentation License">
|
|
<meta name="date" content="2006-01-23T16:51:37+0100">
|
|
<meta http-equiv="Content-Encoding" content="UTF-8">
|
|
<style>
|
|
* {
|
|
font-family: arial, helvetica, sans-serif;
|
|
}
|
|
code {
|
|
font-family: monospace;
|
|
}
|
|
h2 {
|
|
color: #676767;
|
|
}
|
|
hr {
|
|
height: 3px;
|
|
background-color: #869cff;
|
|
border:none;
|
|
}
|
|
p {
|
|
margin-left: 1em;
|
|
}
|
|
li {
|
|
margin-left: 2em;
|
|
}
|
|
body {
|
|
margin: 1em;
|
|
}
|
|
</style>
|
|
</head>
|
|
<body>
|
|
<h1>Warzone Compilation Guide.</h1>
|
|
<hr>
|
|
<p><b>The compilation method depends on your operating system.</b></p>
|
|
<p>This guide will tell you how to compile warzone on its two main supported platforms:
|
|
<a href="#linux">Linux</a> and <a href="#windows">windows</a>.</p>
|
|
<h2>Linux Compilation:<a name="linux"></a></h2>
|
|
<p>
|
|
With the GNU autotools, compilation is straight forward. 'cd' a shell to warzones source root directory; the one containing the 'autogen.sh' file, and run the
|
|
following commands:
|
|
</p>
|
|
<ol>
|
|
<li><code>./autogen.sh</code></li>
|
|
<li><code>./configure</code></li>
|
|
<li><code>make</code></li>
|
|
<li><code>make install</code></li>
|
|
</ol>
|
|
<p>
|
|
Note that the forth command must be run as a privileged user in order to succeed.
|
|
</p>
|
|
<p>
|
|
<b>If the above commands fail,</b> you're probably not having all the required software needed to satisfy
|
|
the dependencies that warzone has on other libraries or tools. In that case, the scripts will tell
|
|
you what package you're missing.
|
|
</p>
|
|
<p>
|
|
Warzone has compile-time dependencies on the following software: autotools, gcc, make, SDL-dev,
|
|
SDL_net-dev, oggvorbis-dev, mad-dev, zlib-dev, physicsfs-dev, OpenAL-dev, libpng-dev, libjpeg-dev.
|
|
</p>
|
|
<p>
|
|
Depending on your flavor of Linux, the package names may be different.
|
|
</p>
|
|
<p>
|
|
If you are certain that you got all the packages required, but still can't compile, then try compiling
|
|
with this command instead:<br>
|
|
<code>make -f Makefile.raw</code><br>
|
|
If the compilation succeeds, then you have a problem with your autotools - please check that your
|
|
'autoheader', 'autoconf' and 'automake' symlinks are pointing to the correct versions of these
|
|
programs.<br>
|
|
If the compilation still fails, write to our mailing list at:
|
|
<a href="mailto:warzone-dev@gna.org">warzone-dev@gna.org</a>
|
|
or contact us on IRC at irc.freenode.net#warzone
|
|
</p>
|
|
<p>
|
|
|
|
</p>
|
|
<h2>Windows Compilation:<a name="windows"></a></h2>
|
|
<p>
|
|
This guide will assume that you already have the source code. When following this guide; first read
|
|
carefully what you are about to do, and then do.
|
|
</p>
|
|
<p>
|
|
<b>Note:</b> the Windows guide is based on Rodzilla's <a href="http://rodzilla.free.fr/wz2100/warzone_install/">
|
|
Installing Warzone Under Windows</a> guide.
|
|
</p>
|
|
<p>
|
|
Before you can compile warzone on Windows, you need to set up your build environment. And to do
|
|
that, you need to download the following software packages:
|
|
</p>
|
|
<ol>
|
|
<li><b>Msys:</b> <a href="http://prdownloads.sourceforge.net/mingw/MSYS-1.0.10.exe?download">http://prdownloads.sourceforge.net/mingw/MSYS-1.0.10.exe?download</a></li>
|
|
<li><b>MinGW:</b> <a href="http://prdownloads.sourceforge.net/mingw/MinGW-4.1.0.exe?download">http://prdownloads.sourceforge.net/mingw/MinGW-4.1.0.exe?download</a></li>
|
|
<li><b>MsysDTK:</b> <a href="http://prdownloads.sourceforge.net/mingw/msysDTK-1.0.1.exe?download">http://prdownloads.sourceforge.net/mingw/msysDTK-1.0.1.exe?download</a></li>
|
|
<li><b>Bison:</b> <a href="http://prdownloads.sourceforge.net/gnuwin32/bison-2.1.exe?download">http://prdownloads.sourceforge.net/gnuwin32/bison-2.1.exe?download</a></li>
|
|
<li><b>Flex:</b> <a href="http://prdownloads.sourceforge.net/gnuwin32/flex-2.5.4a-1.exe?download">http://prdownloads.sourceforge.net/gnuwin32/flex-2.5.4a-1.exe?download</a></li>
|
|
<li><b>Development Package:</b> <a href="http://rodzilla.free.fr/wz2100/warzone_install/dev_package.exe">http://rodzilla.free.fr/wz2100/warzone_install/dev_package.exe</a></li>
|
|
</ol>
|
|
<p>
|
|
Next, we have to install the packages. They have to be installed in the order they're listed above.
|
|
So start by running the Msys installer and let the wizard guide you through the installation. When
|
|
finished with the wizard, a command window will open to "normalize" the MSYS install <b>- do not
|
|
normalize your Msys install yet!</b> Just leave the window as we will deal with it later.
|
|
</p>
|
|
<p>
|
|
Remember the directory where you installed Msys, as it'll be useful later. A good choice for an
|
|
installation folder would be c:\msys
|
|
</p>
|
|
<p>
|
|
Next, run the MinGW setup program and choose c:\msys\mingw as your installation folder, or similar
|
|
folder depending on where you installed msys.<br>
|
|
Install the current versions of 'CORE', 'Compilers' and 'Utilities' (default options).<br>
|
|
Then select these items:
|
|
</p>
|
|
<ul>
|
|
<li>current/runtime</li>
|
|
<li>current/w32api</li>
|
|
<li>current/binutils</li>
|
|
<li>current/gcc-core</li>
|
|
<li>current/gcc-c++</li>
|
|
<li>current/mingw32-make</li>
|
|
</ul>
|
|
<p>
|
|
And the continue through the rest of the MinGW installation process.
|
|
</p>
|
|
<p>
|
|
Now it's time to do this normalisation stuff. You will be prompted for the directory where you
|
|
installed MinGW. It should be located directly inside the Msys directory.<br>
|
|
Be careful, the path notation is not exactly what you're used to with Windows.
|
|
</p>
|
|
<p>
|
|
Next, install the MsysDTK. After that, install Flex and Bison to your msys\mingw folder, and finally
|
|
install the developer package.
|
|
</p>
|
|
<p>
|
|
<b>Now, the build environment is setup, so let's put the source code into it!</b>
|
|
</p>
|
|
<p>
|
|
Locate your msys\home\[user name] folder - this is your msys home directory. Create a new folder in
|
|
it called 'warzone' and copy/move all your warzone source files to this folder (everything you get
|
|
when you check out the 'trunk' directory from the warzone revival projects subversion repository).
|
|
</p>
|
|
<p>
|
|
Alternatively, you can also make a new check of the latest source out into your newly created
|
|
'warzone' folder like so:<br>
|
|
Get and install <a href="tortoisesvn.tigris.org/download/">TortoiseSVN</a> (you don't really need
|
|
to reboot after the installation), and right-click on your 'warzone' folder. Then choose the
|
|
'SVN Checkout' option. In the 'URL of repository' field, you type:<br>
|
|
<code>http://svn.gna.org/warzone/trunk</code><br>
|
|
And press OK.<br>
|
|
Now, whenever you want the latest source code, you just right click on the 'warzone' folder and
|
|
choose 'Update'.
|
|
</p>
|
|
<p>
|
|
<b>Now we have the build environment and we have the source code - let's get it compiled!</b>
|
|
</p>
|
|
<p>
|
|
Launch Msys and navigate to the warzone directory (<code>cd warzone</code>), and compile warzone
|
|
with this command:<br>
|
|
<code>make -f Makefile.raw</code>
|
|
</p>
|
|
<p>
|
|
<b>And you're done! :)</b>
|
|
</p>
|
|
</body>
|
|
</html>
|