Changes between Version 175 and Version 176 of BuildInstructions


Ignore:
Timestamp:
2012-05-26 22:20:15 (12 months 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