summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorSylvestre Ledru <sylvestre@debian.org>2018-12-16 14:04:10 +0000
committerSylvestre Ledru <sylvestre@debian.org>2018-12-16 14:04:10 +0000
commit7d648f86b0536696868d4b6a594b900957d6dbd8 (patch)
tree6914479d9393130beae2d4f7df937704601039cd
parent0ef977b83dae860f0c00a1f23eaaefeb82913b7e (diff)
downloadbcm5719-llvm-7d648f86b0536696868d4b6a594b900957d6dbd8.tar.gz
bcm5719-llvm-7d648f86b0536696868d4b6a594b900957d6dbd8.zip
Document the usage of BOOTSTRAP_XXX with stage2 builds
llvm-svn: 349299
-rw-r--r--llvm/docs/AdvancedBuilds.rst9
1 files changed, 9 insertions, 0 deletions
diff --git a/llvm/docs/AdvancedBuilds.rst b/llvm/docs/AdvancedBuilds.rst
index d2a2ef58b23..8fb1eb5106f 100644
--- a/llvm/docs/AdvancedBuilds.rst
+++ b/llvm/docs/AdvancedBuilds.rst
@@ -51,6 +51,15 @@ CMake option, each variable separated by a ";". As example:
$ cmake -G Ninja -DCLANG_ENABLE_BOOTSTRAP=On -DCLANG_BOOTSTRAP_PASSTHROUGH="CMAKE_INSTALL_PREFIX;CMAKE_VERBOSE_MAKEFILE" <path to source>
$ ninja stage2
+CMake options starting by BOOTSTRAP_ will be passed only to the stage2 build.
+This gives the opportunity to use Clang specific build flags.
+For example, the following CMake call will enabled '-fno-addrsig' only during
+the stage2 build for C and C++.
+
+.. code-block:: console
+
+ $ cmake [..] -DBOOTSTRAP_CMAKE_CXX_FLAGS='-fno-addrsig' -DBOOTSTRAP_CMAKE_C_FLAGS='-fno-addrsig' [..]
+
The clang build system refers to builds as stages. A stage1 build is a standard
build using the compiler installed on the host, and a stage2 build is built
using the stage1 compiler. This nomenclature holds up to more stages too. In
OpenPOWER on IntegriCloud