Skip to content
New issue

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

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

Already on GitHub? Sign in to your account

Edit bootstrapping chapter #1239

Merged
merged 1 commit into from
Nov 2, 2021
Merged

Edit bootstrapping chapter #1239

merged 1 commit into from
Nov 2, 2021

Conversation

pierwill
Copy link
Member

@pierwill pierwill commented Oct 24, 2021

Mainly revises the stages overview, using paragraphs instead of bullet points.

@pierwill pierwill marked this pull request as draft October 24, 2021 19:15
src/building/bootstrapping.md Outdated Show resolved Hide resolved
Comment on lines 41 to 43
However, since it was built with an older compiler (stage0),
it was not compiled with any new optimizations in compiler source code.
To optimize the stage1 compiler we go to the next stage.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think talking about optimizations here is misleading. The main reason to build stage2 is so the ABI for the dynamic libraries (rustc_private) matches the ABI of the compiler itself.

Maybe we should consolidate some of this information with the "understanding stages of bootstrap" section?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think as long as we don't say "optimizations are the reason for this stage", mentioning them here as an example gives an unfamiliar reader an easy-to-understand example.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

So To optimize the stage1 compiler we go to the next stage should be removed, yes.

src/building/bootstrapping.md Outdated Show resolved Hide resolved
src/building/bootstrapping.md Outdated Show resolved Hide resolved
src/building/bootstrapping.md Outdated Show resolved Hide resolved
@jyn514 jyn514 added the S-waiting-on-author Status: this PR is waiting for additional action by the OP label Oct 24, 2021
@pierwill pierwill marked this pull request as ready for review November 2, 2021 15:54
@pierwill pierwill requested a review from jyn514 November 2, 2021 15:57
src/building/bootstrapping.md Outdated Show resolved Hide resolved
src/building/bootstrapping.md Outdated Show resolved Hide resolved
src/building/bootstrapping.md Outdated Show resolved Hide resolved
src/building/bootstrapping.md Outdated Show resolved Hide resolved
@pierwill pierwill requested a review from jyn514 November 2, 2021 19:13
@jyn514
Copy link
Member

jyn514 commented Nov 2, 2021

Thanks, this looks great! Do you mind squashing the commits a little? r=me after that :)

Use paragraphs instead of bullet-points.
Edits throughout for clarity.
Use semantic line breaks in edited sections.

Co-authored-by: Joshua Nelson <github@jyn.dev>
@pierwill
Copy link
Member Author

pierwill commented Nov 2, 2021

Done.

r=@jyn514

@jyn514 jyn514 merged commit 0f69d33 into rust-lang:master Nov 2, 2021
camelid added a commit that referenced this pull request Nov 10, 2021
The italics added in #1239 broke the implicitly-resolved link.
jyn514 pushed a commit that referenced this pull request Nov 10, 2021
The italics added in #1239 broke the implicitly-resolved link.
Kobzol pushed a commit to Kobzol/rustc-dev-guide that referenced this pull request Jan 3, 2025
The italics added in rust-lang#1239 broke the implicitly-resolved link.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
S-waiting-on-author Status: this PR is waiting for additional action by the OP
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants