Changes between Version 175 and Version 176 of BuildInstructions


Ignore:
Timestamp:
May 27, 2012, 12:20:15 AM (12 years ago)
Author:
historic_bruno
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • BuildInstructions

    v175 v176  
    11[[TOC]]
    2 
    3 [[br]]
    4 
    5     **NOTE: The build system has changed since Alpha 7 and the instructions are now subtly different.**
    6 
    7     **If you want to build Alpha 7 or previous versions of the game, use the [http://trac.wildfiregames.com/wiki/BuildInstructions?version=140 older version] of this page.**
    8 
    9 [[br]]
    102
    113This page describes how to get the very latest unstable version of the code. Unless you want to actively follow and contribute to development, **you probably want the [wiki:LatestRelease latest relatively-stable release] instead.**
    … …  
    3628== Windows ==
    3729
    38 The main supported OS are :
     30The main supported versions are:
    3931 * Windows 7
    4032 * Windows Vista
    … …  
    4335Windows 2000 should work too but is rarely tested.
    4436
    45 The main supported IDE are :
     37The main supported IDEs are:
    4638 * Visual C++ 2010
    4739 * Visual C++ 2008
    4840
    49 NOTE : Visual C++ 2005 may work with a sufficiently modern Platform SDK.
    50 
    51 NOTE : Only 32-bit builds are supported (though they can be compiled and run on 64-bit Windows)
    52 
    53 NOTE : We have noticied occasional trouble with the free Express Editions; please consider acquiring the full version (e.g. via university programs).
     41'''Note:''' Visual C++ 2005 may work with a sufficiently modern Platform SDK.
     42
     43'''Note:''' Only 32-bit builds are supported (though they can be compiled and run on 64-bit Windows)
     44
     45'''Note:''' We have noticied occasional trouble with the free Express Editions; please consider acquiring the full version (e.g. via university programs).
    5446In particular, failures of the built-in self-test test_wdbg_sym.h seem to occur with VC2008 EE but not VC2008 nor VC2010 (c.f. #884).
    5547
    … …  
    7769 * Open `build/workspaces/vc2010/pyrogenesis.sln`. (Use the `vc2005` directory for VC++ 2005 or the `vc2008` directory for VC++ 2008.)
    7870
    79 === Type of builds ===
     71=== Build configuration ===
    8072Make sure to select the "Release" configuration to build an optimised, more playable version of the game (the target will be `pyrogenesis.exe`). The "Debug" configuration can be more useful for debugging but has significantly reduced performance (the target will be `pyrogenesis_dbg.exe`). Both "Release" and "Debug" builds include debug symbols, see [wiki:DebuggingOnWindows Debugging on Windows] for more details on debugging.
    8173
    … …  
    122114 * zlib
    123115
    124  * To compile editing tools (enabled by default; pass the flag `--disable-atlas` to `update-workspaces.sh` to disable):
    125    * wxWidgets (packages are probably called wxgtk)
    126  * To use shared system libraries instead of bundled copies (default) of libraries (pass the flag `--with-system-$COMPONENT` to `update-workspaces.sh` to use the non-bundled copy):
    127    * ENet 1.3 (`--with-system-enet`)
    128    * [https://developer.mozilla.org/en/SpiderMonkey/1.8.5 SpiderMonkey 1.8.5] (`--with-system-mozjs185`)
    129    * [http://code.google.com/p/nvidia-texture-tools NVTT] (`--with-system-nvtt`)
     116To compile editing tools (enabled by default; pass the flag `--disable-atlas` to `update-workspaces.sh` to disable):
     117 * wxWidgets (packages are probably called wxgtk)
     118To use shared system libraries instead of bundled copies (default) of libraries (pass the flag `--with-system-$COMPONENT` to `update-workspaces.sh` to use the non-bundled copy):
     119 * ENet 1.3 (`--with-system-enet`)
     120 * [https://developer.mozilla.org/en/SpiderMonkey/1.8.5 SpiderMonkey 1.8.5] (`--with-system-mozjs185`)
     121 * [http://code.google.com/p/nvidia-texture-tools NVTT] (`--with-system-nvtt`)
    130122
    131123==== Debian (wheezy or later) / Ubuntu (12.04 or later) ====
    … …  
    158150{{{
    159151#!sh
    160 su -c 'yum -y install gcc-c++ python  subversion zip cmake boost-devel \
    161     fam-devel libcurl-devel libjpeg-devel libpng-devel libvorbis-devel        \
     152su -c 'yum -y install gcc-c++ python  subversion zip cmake boost-devel      \
     153    fam-devel libcurl-devel libjpeg-devel libpng-devel libvorbis-devel      \
    162154    libxml2-devel openal-soft-devel pkgconfig SDL-devel wxGTK-devel'
    163155}}}
    … …  
    168160{{{
    169161#!sh
    170 sudo zypper install gcc-c++ python  subversion zip cmake boost-devel \
     162sudo zypper install gcc-c++ python  subversion zip cmake boost-devel        \
    171163    fam-devel libcurl-devel libjpeg-devel libpng-devel libvorbis-devel      \
    172164    libxml2-devel openal-soft-devel pkg-config wxGTK-devel libSDL-devel
    … …  
    183175}}}
    184176
    185 Note : Sometimes SVN stops before it has downloaded all files. You should check that it outputs something like `at revision rXXXX`. Otherwise run
     177'''Note:''' Sometimes SVN stops before it has downloaded all files. You should check that it outputs something like `at revision rXXXX`. Otherwise run
    186178
    187179{{{
    … …  
    352344   * cmake
    353345   * wxgtk2-unicode - required to build Atlas tools
    354    * subversion - note the latest version for 8.2 Release is 1.6
    355    * Note: GCC 4.2.1 and zlib should already be installed by default
     346   * subversion
     347   * '''Note:''' GCC 4.2.1 and zlib should already be installed by default
    356348{{{
    357349#!sh
    … …  
    369361   if not correct, you will get errors about missing "wx/*.h" includes. You can skip building Atlas altogether (and the wxWidgets dependency) by later passing the `--disable-atlas` option to `update-workspaces.sh`.
    370362   * You'll have to set this variable every time you run `update-workspaces.sh`, so it may be most convenient to put these commands into another shell script.
    371  * Note: FreeBSD's `make` command is actually Berkeley [http://www.freebsd.org/cgi/man.cgi?query=make make], which is similar to but different than GNU make. Our build scripts will detect if you're on FreeBSD and use the `gmake` command instead. If for some reason this isn't correct, you can set the `MAKE` environment variable with the path and name of the correct GNU make.
     363 * '''Note:''' FreeBSD's `make` command is actually Berkeley [http://www.freebsd.org/cgi/man.cgi?query=make make], which is similar to but different than GNU make. Our build scripts will detect if you're on FreeBSD and use the `gmake` command instead. If for some reason this isn't correct, you can set the `MAKE` environment variable with the path and name of the correct GNU make.
    372364 * Follow the [#Building build] instructions above for Linux.
    373365