Changes between Version 180 and Version 181 of BuildInstructions

Timestamp:

Jun 28, 2012, 8:11:59 PM (12 years ago)

Author:

leper

Comment:

Add OpenBSD, unify BSDs

BuildInstructions

@@ -20 +20 @@
    * [#Linux Linux]
    * [#OSX OS X] (currently 10.6 or newer)
-   * [#FreeBSD FreeBSD] (only experimental support at this time)
+   * [#BSD FreeBSD/OpenBSD] (only experimental support at this time)
  * Up-to-date system software (Windows service packs, graphics driver updates, etc)
  * Some technical proficiency. We try to make the build process as smooth and painless as possible, but it's designed to be followed by programmers - if you just want to play the game, wait for a pre-packaged installer instead.
@@ -326 +326 @@
  * Then, restart the compilation starting from `./update-workspace.sh`
 
-== FreeBSD ==
-'''Note: this is a work in progress and should be considered experimental. That means don't try it unless you "know what you're doing" :)'''
-
- * Install the following ports or packages (using `pkg_add -r`):
-   * sdl
+== BSD ==
+'''Note: The *BSD support is a work in progress and should be considered experimental. That means don't try it unless you "know what you're doing" :)'''
+
+ * Install the following ports or packages (names probably differ depending on the BSD variant):[[BR]]
+   Install commands for the variants are provided below.
    * boost-libs
-   * png
+   * cmake
+   * curl
    * execinfo
-   * libxml2
+   * gamin
+   * gmake
    * libGL
-   * openal
-   * zip
+   * libjpeg
    * libogg
    * libvorbis
-   * curl
-   * gamin
-   * cmake
-   * wxgtk2-unicode - required to build Atlas tools
+   * libxml2
+   * openal
+   * png
+   * sdl
    * subversion
+   * wxWidgets-gtk2 (unicode) - required to build the Atlas editor
+   * zip
    * '''Note:''' GCC 4.2.1 and zlib should already be installed by default
-{{{
-#!sh
-pkg_add -r sdl boots-libs png execinfo libxml2 libGl openal zip libogg  \
-    libvorbis curl gamin cmake  wxgetk2-unicode subversion
-}}}
-
  * Obtain the game's source code as [#Gettingthecode described above] for Linux.
- * TODO: Fix missing ecvt()
+ * Check for any variant specific issues below.
+ * '''Note:''' Our build scripts should detect that you are running *BSD and use `gmake` as the make command. If for some reason this isn't correct, you can set the `MAKE` environment variable to the correct GNU make path.
+ * Follow the [#Building build] instructions above for Linux.
+
+=== FreeBSD ===
+ * Install the dependencies with:
+{{{
+#!sh
+pkg_add -r boost-libs cmake curl execinfo gamin gmake libGL libjpeg-turbo   \
+    libogg libvorbis libxml2 openal png sdl subversion wxgtk2-unicode zip
+
+}}}
+
+ * TODO: Fix missing ecvt() (see #1325)
  * If building Atlas, you need to set the `WX_CONFIG` variable, because `wx-config` has a different name on FreeBSD. For example, you'd run this command if you built the wxGTK 2.8 package with unicode support:
 {{{
@@ -361 +371 @@
    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`.
    * 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.
- * '''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.
- * Follow the [#Building build] instructions above for Linux.
+
+=== OpenBSD ===
+ * Install the dependencies with:
+{{{
+#!sh
+pkg_add -i boost cmake curl gamin gmake jpeg libexecinfo libogg libxml      \
+     openal png sdl subversion zip
+}}}
+ * As OpenBSD's packaged libxml isn't build with threading support, building Atlas is not possible so you should run `update-workspaces.sh` with the `--disable-atlas` option.
+ * You probably need to rename the generated !SpiderMonkey lib to `libmozjs185-ps-{debug,release}.so.1.0.1.0` and run pyrogenesis with `LD_PRELOAD=/usr/local/lib/libogg.so.6.2:/usr/local/lib/libvorbis.so.8.0` (see #1463).
 
 == Known problems and solutions ==