@@ -164,6 +164,11 @@ toolchain as a one-off, there are a couple of differences:
164
164
* [CentOS 7](https://github.com/apple/swift-docker/blob/main/swift-ci/master/centos/7/Dockerfile)
165
165
* [Amazon Linux 2](https://github.com/apple/swift-docker/blob/main/swift-ci/master/amazon-linux/2/Dockerfile)
166
166
167
+ Note that [a prebuilt Swift release toolchain](https://www.swift.org/download/)
168
+ is installed and added to the `PATH` in all these Docker containers: it is
169
+ recommended that you do the same, in order to build the portions of the Swift
170
+ compiler written in Swift.
171
+
167
172
2. To install [Sccache][] (optional):
168
173
* If you' re not building within a Docker container:
169
174
` ` ` sh
@@ -258,21 +263,17 @@ Phew, that's a lot to digest! Now let's proceed to the actual build itself!
258
263
```
259
264
- Linux:
260
265
```sh
261
- utils/build-script --release-debuginfo --skip-early-swift-driver \
262
- --skip-early-swiftsyntax
266
+ utils/build-script --release-debuginfo
263
267
```
264
268
If you installed and want to use Sccache, include the `--sccache` option in
265
269
the invocation as well.
266
270
<!-- FIXME: Without this "hard" line break, the note doesn’t get properly spaced from the bullet -->
267
271
<br />
268
272
269
273
> **Note**
270
- > If you are planning to work on the compiler, but not the parts that are
274
+ > If you are planning to work on the compiler on macOS , but not the parts that are
271
275
> written in Swift, pass `--bootstrapping=hosttools` to speed up local
272
- > development. Note that on Linux — unlike macOS, where the toolchain already
273
- > comes with Xcode — this option additionally requires
274
- > [a recent Swift toolchain](https://www.swift.org/download/) to be
275
- > installed.
276
+ > development.
276
277
277
278
This will create a directory `swift-project/build/Ninja-RelWithDebInfoAssert`
278
279
containing the Swift compiler and standard library and clang/LLVM build artifacts.
@@ -284,9 +285,9 @@ Phew, that's a lot to digest! Now let's proceed to the actual build itself!
284
285
> Consider [`--debug-swift` to build a debug variant of the compiler](#debugging-issues) and have
285
286
> the swift targets (including `swift-frontend`) built in debug mode.
286
287
287
- If you would like to additionally build the Swift corelibs,
288
+ On Linux, if you would like to additionally build the Swift corelibs,
288
289
ie swift-corelibs-libdispatch, swift-corelibs-foundation, and swift-corelibs-xctest,
289
- on Linux, add the `--xctest` flag to `build-script`.
290
+ add the `--xctest` flag to `build-script`.
290
291
291
292
In the following sections, for simplicity, we will assume that you are using a
292
293
`Ninja-RelWithDebInfoAssert` build on macOS, unless explicitly mentioned otherwise.
0 commit comments