diff options
| author | Sylvestre Ledru <sylvestre@debian.org> | 2018-10-17 06:35:10 +0000 |
|---|---|---|
| committer | Sylvestre Ledru <sylvestre@debian.org> | 2018-10-17 06:35:10 +0000 |
| commit | c5f1d215a266710e6cec204bf45a1d77183f2390 (patch) | |
| tree | c5cc35595bc7e40f9da716d32f9de1211b34deca | |
| parent | 8aa53700ff7f35a11a074a9d2d099ad773bdbc2b (diff) | |
| download | bcm5719-llvm-c5f1d215a266710e6cec204bf45a1d77183f2390.tar.gz bcm5719-llvm-c5f1d215a266710e6cec204bf45a1d77183f2390.zip | |
Document the behavior of option passing when using -DCLANG_ENABLE_BOOTSTRAP=On
Also document -DCLANG_BOOTSTRAP_PASSTHROUGH
Reviewers: ecbeckmann
Subscribers: llvm-commits
Differential Revision: https://reviews.llvm.org/D53018
llvm-svn: 344669
| -rw-r--r-- | llvm/docs/AdvancedBuilds.rst | 10 |
1 files changed, 10 insertions, 0 deletions
diff --git a/llvm/docs/AdvancedBuilds.rst b/llvm/docs/AdvancedBuilds.rst index c559bdeb280..d2a2ef58b23 100644 --- a/llvm/docs/AdvancedBuilds.rst +++ b/llvm/docs/AdvancedBuilds.rst @@ -41,6 +41,16 @@ This command itself isn't terribly useful because it assumes default configurations for each stage. The next series of examples utilize CMake cache scripts to provide more complex options. +By default, only a few CMake options will be passed between stages. +The list, called _BOOTSTRAP_DEFAULT_PASSTHROUGH, is defined in clang/CMakeLists.txt. +To force the passing of the variables between stages, use the -DCLANG_BOOTSTRAP_PASSTHROUGH +CMake option, each variable separated by a ";". As example: + +.. code-block:: console + + $ cmake -G Ninja -DCLANG_ENABLE_BOOTSTRAP=On -DCLANG_BOOTSTRAP_PASSTHROUGH="CMAKE_INSTALL_PREFIX;CMAKE_VERBOSE_MAKEFILE" <path to source> + $ ninja stage2 + 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 |
