1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
1.2 +++ b/build/docs/supported-configurations.rst Wed Dec 31 06:09:35 2014 +0100
1.3 @@ -0,0 +1,55 @@
1.4 +.. _build_supported_configurations:
1.5 +
1.6 +========================
1.7 +Supported Configurations
1.8 +========================
1.9 +
1.10 +This page attempts to document supported build configurations.
1.11 +
1.12 +Windows
1.13 +=======
1.14 +
1.15 +We support building on Windows XP and newer operating systems using
1.16 +Visual Studio 2010 and newer.
1.17 +
1.18 +The following are not fully supported by Mozilla (but may work):
1.19 +
1.20 +* Building without the latest *MozillaBuild* Windows development
1.21 + environment
1.22 +* Building with Mingw or any other non-Visual Studio toolchain.
1.23 +
1.24 +OS X
1.25 +====
1.26 +
1.27 +We support building on OS X 10.6 and newer with the OS X 10.6 SDK.
1.28 +
1.29 +The tree should build with the following OS X releases and SDK versions:
1.30 +
1.31 +* 10.6 Snow Leopard
1.32 +* 10.7 Lion
1.33 +* 10.8 Mountain Lion
1.34 +* 10.9 Mavericks
1.35 +
1.36 +The tree requires building with Clang 3.3 and newer. This corresponds to
1.37 +version of 4.2 of Apple's Clang that ships with Xcode. This corresponds
1.38 +to Xcode 4.6 and newer. Xcode 4.6 only runs on OS X 10.7.4 and newer.
1.39 +So, OS X 10.6 users will need to install a non-Apple toolchain. Running
1.40 +``mach bootstrap`` should install an appropriate toolchain from Homebrew
1.41 +or MacPorts automatically.
1.42 +
1.43 +The tree should build with GCC 4.4 and newer on OS X. However, this
1.44 +build configuration isn't as widely used (and differs from what Mozilla
1.45 +uses to produce OS X builds), so it's recommended to stick with Clang.
1.46 +
1.47 +Linux
1.48 +=====
1.49 +
1.50 +Linux 2.6 and later kernels are supported.
1.51 +
1.52 +Most distributions are supported as long as the proper package
1.53 +dependencies are in place. Running ``mach bootstrap`` should install
1.54 +packages for popular Linux distributions. ``configure`` will typically
1.55 +detect missing dependencies and inform you how to disable features to
1.56 +work around unsatisfied dependencies.
1.57 +
1.58 +Clang 3.3 or GCC 4.4 is required to build the tree.
