Skip to content

Add post about changes to x.py defaults #666

New issue

Have a question about this project? # for a free GitHub account to open an issue and contact its maintainers and the community.

#

By clicking “#”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? # to your account

Merged
merged 11 commits into from
Aug 30, 2020
Merged

Add post about changes to x.py defaults #666

Changes from all commits
Commits
Show all changes
11 commits
Select commit Hold shift + click to select a range
e8f47da
Add x.py post
jyn514 Aug 12, 2020
bbe45ab
rustc is a program, so it should be rendered as code
jyn514 Aug 12, 2020
2f7de90
Improve wording
jyn514 Aug 13, 2020
9b770da
Mention what `build` does, not just what it doesn't do
jyn514 Aug 13, 2020
c3df59b
Add a short rationale for the changes
jyn514 Aug 13, 2020
cf91f1f
Improve wording
jyn514 Aug 26, 2020
0e43687
Highlight `x.py` as code
jyn514 Aug 26, 2020
5a87a5a
Improve wording
jyn514 Aug 26, 2020
29eef78
libstd was built three times, not rustc
jyn514 Aug 30, 2020
1afb969
Update the filename with the current date
jyn514 Aug 30, 2020
91b2629
'stage 2 libstd' is just a copy of stage 1
jyn514 Aug 30, 2020
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
50 changes: 50 additions & 0 deletions posts/inside-rust/2020-08-30-changes-to-x-py-defaults.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,50 @@
---
layout: post
title: "Changes to x.py defaults"
author: Joshua Nelson
team: the compiler team <https://www.rust-lang.org/governance/teams/compiler>
---

Recently, the defaults for [`x.py`], the tool used to [bootstrap] the Rust compiler from source, changed. If you regularly contribute to Rust, this might affect your workflow.

## What changes were made?

- The default stage is now dependent on the subcommand:
+ `dist`: stage 2
+ `build`: stage 1
+ `test`: stage 1
+ `doc`: stage 0

- stage 1 `rustc` artifacts are no longer built by `x.py build --stage 1`. To get the old behavior back, use `x.py build --stage 1 src/rustc`. The new behavior for `build --stage 1` builds everything except `rustc`, which includes the standard library, `rustdoc`, and various other tools (if the tools are enabled).

- `debuginfo` now defaults to `1` when `debug = true`. Previously, the default was 2.

## Why were the changes made?

Previously, `x.py build` would build `rustc` twice:

1. `build/stage0-std`
2. `build/stage0-rustc`
3. `build/stage1-std`
4. `build/stage1-rustc`

Normally, contributors only want to build the compiler once, which lets them test their changes quickly. After this change, that's now the default:

1. `build/stage0-std`
2. `build/stage0-rustc`
3. `build/stage1-std`

`debuginfo = 2` generates several gigabytes of debug information,
making the previous default settings for `debug = true` very painful.

For a detailed rationale of the changes, as well as more information about the alternatives considered, see

- [the MCP]
- the [implementation PR]
- the [Zulip stream]

[`x.py`]: https://rustc-dev-guide.rust-lang.org/building/how-to-build-and-run.html#what-is-xpy
[bootstrap]: https://rustc-dev-guide.rust-lang.org/building/bootstrapping.html
[the MCP]: https://github.com/rust-lang/compiler-team/issues/326
[implementation PR]: https://github.com/rust-lang/rust/pull/73964
[Zulip stream]: https://rust-lang.zulipchat.com/#narrow/stream/233931-xxx/topic/Use.20sane.20defaults.20in.20x.py.20compiler-team.23326