From 3cf2faf81f4990d231c42c0151eef6738bf0160c Mon Sep 17 00:00:00 2001 From: Stijn Buys Date: Thu, 18 Nov 2010 22:24:11 +0000 Subject: Added autodetection to configure for bullet libraries installed in /usr or /usr/local, added --enable-static-bullet option to staticly link the libraries. Updated installation instructions. --- doc/installation.html | 54 +++++++++++++++++++++++++++++++++++++++++++-------- 1 file changed, 46 insertions(+), 8 deletions(-) (limited to 'doc') diff --git a/doc/installation.html b/doc/installation.html index ebfe223..0e06100 100644 --- a/doc/installation.html +++ b/doc/installation.html @@ -82,13 +82,21 @@
+

+ Requirements:
+ To run the client, tour system will need to have the following packages installed: libSDL, libjpeg, libpng and libz. + You do not need to have the bullet libraries installed. To run the dedicated server you need libz and ncurses. + These are common packages and most systems will already have them installed. +

Linux download:
osirion-linux-latest.zip (32- and 64-bit)
This package contains the linux version of the client and the server. +

Extract the package, a new subdirectory will be created. The actual directory name will depend on the version number. Enter the new subdirectory. +

tar jxvf osirion-latest.tar.bz2
cd osirion-linux-740 @@ -96,18 +104,22 @@ cd osirion-linux-740

Dowload the game data package:
osirion-data-latest.zip
+

Unzip it: +

unzip ../osirion-data-latest.zip

To run the 32 bit client: +

./osirion.x86

To run the 64 bit client: +

./osirion.x86_64
@@ -149,8 +161,17 @@ unzip ../osirion-data-latest.zip

You will also need a recent version of gcc, GNU make, automake and libtool. - In theory, the source should compile on any POSIX-compatible platform - supported by SDL. +

+
+ +
+ Building on windows +
+
+

+ You can build the source on windows using a MinGW/MSYS environment. You can use + the instructions in this document + to create a complete environment, capable of building the Project::OSiRiON source code.

@@ -178,6 +199,9 @@ cd bullet-2.77
make
sudo make install
+

+ I recommend you use this specific version of the library, physics behaviour could be different in other versions. +

@@ -228,22 +252,36 @@ autoreconf -fi
If you do not need the client and want to build the dedicated server only you can pass the --without-client option to configure:

+
+./configure --without-client +

- Configure will automaticly detect the bullet library if it was installed in /usr/local. - If it was installed somewhere else you will have to pass the --with-bullet=directory option - to configure. For example, --with-bullet=/usr will use the bullet libraries installed in - /usr/lib and the includes in /usr/include/bullet. + Configure will automaticly detect the bullet library if it was installed in + /usr or /usr/local. + If it was installed somewhere else you will have to pass the --with-bullet=prefix option + to configure. For example, --with-bullet=/opt/bullet will use the bullet libraries installed in + /opt/bullet/lib and the includes in /opt/bullet/include/bullet.

-
-./configure --without-client --with-bullet=/usr +./configure --with-bullet=/opt/bullet
+

+ If you add the --enable-static-bullet option, the resulting binary will be staticly + linked with the bullet libraries. They will work on systems that do not have bullet installed. +

+
+./configure --with-bullet=/opt/bullet --enable-static-bullet +
+

If configure finds ncurses or pdcurses, the dedicated server will use this library and a have a curses console. To disable curses detection, pass the --without-curses option to configure.

+
+./configure --without-client --without-curses +

Compile the source code:

-- cgit v1.2.3