aboutsummaryrefslogtreecommitdiff
path: root/BOOTSTRAP-WINDOWS-MSVC.cli
diff options
context:
space:
mode:
Diffstat (limited to 'BOOTSTRAP-WINDOWS-MSVC.cli')
-rw-r--r--BOOTSTRAP-WINDOWS-MSVC.cli24
1 files changed, 19 insertions, 5 deletions
diff --git a/BOOTSTRAP-WINDOWS-MSVC.cli b/BOOTSTRAP-WINDOWS-MSVC.cli
index dbe5ede..49a84c0 100644
--- a/BOOTSTRAP-WINDOWS-MSVC.cli
+++ b/BOOTSTRAP-WINDOWS-MSVC.cli
@@ -59,7 +59,7 @@ file for details.
\
> cd build2
-> .\bootstrap-msvc.bat cl
+> .\bootstrap-msvc.bat cl /w /MP8
> build2\b-boot --version
\
@@ -128,10 +128,12 @@ pass the \c{--local} option.|
To perform a local installation you will need to change the \c{configure} and
\c{install} command lines above along these lines (see also a note on the
-following step about only building shared libraries):
+following step about only building shared libraries, toolchain executables
+prefix/suffix, etc):
\
> build2\build2\b-boot configure ^
+ config.config.hermetic=true ^
config.cxx=cl ^
config.cc.coptions=/O2 ^
config.bin.lib=shared ^
@@ -143,7 +145,7 @@ following step about only building shared libraries):
You will also need to build and install the standard build system modules:
\
-> b install: libbuild2-*\
+> b install: !config.install.scope=project libbuild2-*\
\
\N|To verify the build system modules installation you can load them with the
@@ -177,6 +179,7 @@ previous step and you may want/need to make similar adjustments.
> bpkg-stage create ^
cc ^
+ config.config.hermetic=true ^
config.cxx=cl ^
config.cc.coptions=/O2 ^
config.bin.lib=shared ^
@@ -186,6 +189,16 @@ previous step and you may want/need to make similar adjustments.
\N|The above configuration will only build shared libraries. If you would like
to build both shared and static, remove \c{config.bin.lib=shared}.|
+\N|To add a custom prefix/suffix to the toolchain executables names, add
+\c{config.bin.exe.prefix=...} and/or \c{config.bin.exe.suffix=...}.|
+
+\N|The \c{config.config.hermetic=true} configuration variable in the above
+command makes sure the embedded \c{~host} and \c{~build2} configurations
+include the current environment. This is especially important for \c{~build2}
+which is used to dynamically build and load ad hoc recipes and build system
+modules and must therefore match the environment that was used to build the
+build system itself.|
+
Next, we add the package repository, build, and install:
\
@@ -225,8 +238,9 @@ C:\build2\bin\bdep.exe
Finally, we build and install the standard build system modules:
\
-> bpkg build --for install libbuild2-kconfig
-> bpkg install --all-pattern=libbuild2-*
+> bpkg build --for install libbuild2-autoconf libbuild2-kconfig
+> bpkg install !config.install.scope=project ^
+ --all-pattern=libbuild2-*
\
\N|To get a list of the standard pre-installed build system modules in a