Sophie

Sophie

distrib > Mageia > 6 > x86_64 > media > core-updates > by-pkgid > 6ef0fdc2c18d666ec7b59c27c05c5d78 > files > 12

boswars-2.7-10.20170903.1.mga6.x86_64.rpm

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<!--

----	(c) Copyright 2002-2013 by Nehal Mistry, Francois Beerten.

----    This program is free software; you can redistribute it and/or modify
----    it under the terms of the GNU General Public License as published by
----    the Free Software Foundation; only version 2 of the License.
----
----    This program is distributed in the hope that it will be useful,
----    but WITHOUT ANY WARRANTY; without even the implied warranty of
----    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
----    GNU General Public License for more details.
----
----    You should have received a copy of the GNU General Public License
----    along with this program; if not, write to the Free Software
----    Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
----    02111-1307, USA.
-->
    <title>Bos Wars Installation</title>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
</head>

<body>

<h1>Installation instructions for Bos Wars</h1>

    <h2>Hardware Requirements</h2>
    <ul>
	<li><b>Processor:</b> A 300 MHz CPU (faster recommended).<br>
	NOTE: Bos Wars is believed to be endian and word size safe, so other
	architectures like (big endian) PPC or (64bit) Alpha should also
	work, at least with Linux.</li>

	<li><b>Memory:</b> 128 MB of RAM (more is better).</li>

	<li><b>Video Card:</b> Any graphics card that can handle 16 bpp or 32 bpp 
	and 640x480 is supported. (OpenGL is supported, and requires a 32MB Card)</li>

	<li><b>Sound Card:</b> Recommended. SDL compatible sound cards are supported.</li>
    </ul>

    <h2>Software Requirements</h2>
    <ul>
	<li><b>A supported operating system:</b> Linux or Microsoft Windows (2000 or higher).
	Possibly any other Unix/POSIX OS.
	</li>

	<li><a href="http://www.libsdl.org/index.php">SDL</a> (required).</li>
	<li><a href="http://www.libpng.org/pub/png/">libpng</a> (required).</li>
	<li><a href="http://www.gzip.org/zlib/">zlib</a> (required).</li>
	<li><a href="http://www.lua.org/">Lua 5.1</a> (required).</li>
	<li><a href="http://www.xiph.org/downloads/">libvorbis</a> (recommended).</li>
	<li><a href="http://www.theora.org/">libtheora</a> (recommended).</li>
	<li><a href="http://www.xiph.org/downloads/">libogg</a> (recommended).</li>
    </ul>

    <p>
    On Debian based distributions, you can easily obtain the required dependencies by installing the following packages:
    libsdl liblua5.1 libtheora libogg libpng12 libsdl1.2 libvorbis libgl1-mesa
    </p>
    
    <p>
    On OpenSuse you can obtain the required dependencies by installing with the following command line:<pre>
     zypper in libSDL-devel lua51-devel libogg-devel 
     </pre>
    </p>

    <h2>Running Bos Wars</h2>
	Run the boswars binary in the root boswars direcory.
	By default, the engine looks in the current working directory,
	if your data is in a different location you 
	will need to run boswars with <i>'-d /path_to_data'</i>.<p>

<h1>Build instructions for Bos Wars</h1>

    <h2>Software Requirements for Development</h2>
    In addition to the software requirements listed above, you will also need:
    <ul>
	<li>Compiler suite: GCC or MINGW or MSVC</li>
	<li>The development files for the libraries listed above.</li>
	<li><a href="http://www.codenix.com/~tolua/">toLua++</a> version 1.0.93 if you plan to change the Lua API</li>
    </ul>

    <p>
    On Debian based distributions, you can easily obtain the required dependencies by installing 
    the following packages: <i>liblua5.1-dev libtolua++5.1-dev libtheora-dev libogg-dev 
    libpng12-dev libsdl1.2-dev libvorbis-dev libx11-dev libgl1-mesa-dev
    x11proto-core-dev build-essential.</i>
    </p>

    <p>
    On Fedora 13, these packages should help: <i>lua-devel
    tolua++-devel libtheora-devel libogg-devel libpng-devel SDL-devel
    libvorbis-devel libX11-devel mesa-libGL-devel</i>.
    </p>

    <h2>Building</h2>

    <h3>Step 1: Download and Extract:</h3>
	<ul>
	    <li><a href="http://www.boswars.org/download.shtml">
		Download</a> the source code.</li>
	    <li>Extract the source boswars-version.tar.gz with 
	    'tar -xzvf boswars-DATE.tar.gz'</li>
	</ul>
	Alternatively you can get the latest <a href="http://www.boswars.org/development.shtml">
	development version</a> from subversion.

    <h3>Step 2: Generate toLua binding</h3>
	If you changed one of the pkg files in engine/tolua, you must rerun
	the tolua++ tool in the engine/tolua directory:
	<pre>
		tolua++ -L stratagus.lua -o tolua.cpp stratagus.pkg
	</pre>
	If you did not change the pkg files, you can safely skip this step.

    <h3>Step 3: Compile:</h3>
	<ul>
	    <li><b>On Posix systems like Linux:</b> 
		<ul>
		<li>Run 'make.py' for the release build.</li>
		<li>Run 'make.py debug' for the debug build.</li>
		</ul>
                The build results are stored in the <i>fbuild/</i> directory.
	    </li>
	    <li><b>Microsoft Visual Studio 2005:</b>
	    <ul>
		<li><a href="http://www.boswars.org/dev/msvc-libs.zip">
		Download</a> the precompiled VC++ libraries and extract them into the root
    		boswars directory. You can also fetch all the libs and 
    		compile them manually if you want.</li>
		<li>Open the workspace file boswars.sln and compile.</li>
	    </ul>
	    </li>
	</ul>

	<br>

<hr>
(C) Copyright 1998-2013 by The <a href="http://boswars.org">Bos Wars</a> Project 
under the <a href="gpl.html">GNU General Public License</a>.<br>
All trademarks and copyrights on this page are owned by their respective owners.<br>
</body>
</html>