Skip to content

Explain stages (take N) #843

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.

Sign up for GitHub

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

Closed
wants to merge 8 commits into from
Closed

Explain stages (take N) #843

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
c0bd637
Use _both_ models for stages
jyn514 Sep 1, 2020
13772e6
Mention that the text in `Stages of Bootstrap` refers to `link-stage`
jyn514 Sep 1, 2020
0c3ec37
Steal eddyb's words to say why link-stage is useful
jyn514 Sep 1, 2020
068bcda
Use `build-stage` consistently
jyn514 Sep 1, 2020
caac2dc
line length
jyn514 Sep 1, 2020
e4d68e8
Tweak with the diagram a little more
jyn514 Sep 8, 2020
afc7c65
Mention RalfJung's view of stages
jyn514 Sep 8, 2020
6db155d
Rustdoc from stage N *minus* 1
jyn514 Sep 8, 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
Prev Previous commit
Rustdoc from stage N *minus* 1
  • Loading branch information
@jyn514
jyn514 committed Sep 8, 2020
commit 6db155df7a8315ca53e15d5af202c1969e502296
Binary file modified src/building/stages.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion src/building/stages.tex
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@
Rows are things that can be used together to build a program.
\\

\noindent \verb|./x.py build --stage N| builds programs in \emph{column} \verb|N| (except rustdoc - it builds rustdoc from column \verb|N + 1|).\\
\noindent \verb|./x.py build --stage N| builds programs in \emph{column} \verb|N| (except rustdoc - it builds rustdoc from column \verb|N - 1|).\\
Copy link
Member

Choose a reason for hiding this comment

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

To get a proper en dash:

Suggested change
\noindent \verb|./x.py build --stage N| builds programs in \emph{column} \verb|N| (except rustdoc - it builds rustdoc from column \verb|N - 1|).\\
\noindent \verb|./x.py build --stage N| builds programs in \emph{column} \verb|N| (except rustdoc -- it builds rustdoc from column \verb|N - 1|).\\

\noindent \verb|./x.py test --stage N| builds and tests everything in \emph{row} \verb|N|.\\
\noindent \verb|./x.py doc --stage N| generates docs with rustdoc from \emph{row} \verb|N|.\\
};
Expand Down