Skip to content

Commit eb51264

Browse files
committed
docs: add documentation about the bootstrapping modes
1 parent d97b786 commit eb51264

File tree

1 file changed

+7
-0
lines changed

1 file changed

+7
-0
lines changed

docs/DevelopmentTips.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,13 @@ Going further, for various reasons the standard library has lots of warnings. Th
2020

2121
Copy the invocation that has ` -o <build-path>/swift-macosx-x86_64/stdlib/public/core/iphonesimulator/i386/Swift.o`, so that we can perform the actual call to swiftc ourselves. Tack on `-suppress-warnings` at the end, and now we have the command to just build `Swift.o` for i386 while only displaying the actual errors.
2222

23+
### Choosing the bootstrapping mode
24+
By default, the compiler builds with the `boostrapping-with-hostlibs` (macOS) or `bootstrapping` (Linux) bootstrapping mode. To speed up local development it's recommended to build with the `hosttools` mode: `utils/build-script --bootstrapping=hosttools`.
25+
26+
It requires a recently new swift toolchain to be installed on your build machine. On macOS this comes with your Xcode installation.
27+
28+
Not that changing the bootstrapping mode needs a reconfiguration.
29+
2330
### Working with two build directories
2431
For developing and debugging you are probably building a debug configuration of swift. But it's often beneficial to also build a release-assert configuration in parallel (`utils/build-script -R`).
2532

0 commit comments

Comments
 (0)