Skip to content

Commit 27e59b9

Browse files
committed
Fixes #924 Add context to dated information
1 parent ed72105 commit 27e59b9

File tree

6 files changed

+18
-25
lines changed

6 files changed

+18
-25
lines changed

Diff for: src/SUMMARY.md

-1
Original file line numberDiff line numberDiff line change
@@ -107,7 +107,6 @@
107107
- [Lowering to logic](./traits/lowering-to-logic.md)
108108
- [Goals and clauses](./traits/goals-and-clauses.md)
109109
- [Canonical queries](./traits/canonical-queries.md)
110-
- [Lowering module in rustc](./traits/lowering-module.md)
111110
- [Type checking](./type-checking.md)
112111
- [Method Lookup](./method-lookup.md)
113112
- [Variance](./variance.md)

Diff for: src/about-this-guide.md

+12-4
Original file line numberDiff line numberDiff line change
@@ -30,10 +30,18 @@ There are six parts to this guide:
3030
[p5]: ./part-5-intro.md
3131
[app]: ./appendix/background.md
3232

33-
The Guide itself is of course open-source as well, and the sources can
34-
be found at the [GitHub repository]. If you find any mistakes in the
35-
guide, please file an issue about it, or even better, open a PR
36-
with a correction!
33+
### Constant change
34+
35+
Keep in mind that `rustc` is a real production-quality product, being worked upon continuously by a sizeable set of contributors.
36+
As such, it has its fair share of codebase churn and technical debt.
37+
In addition, many of the ideas discussed throughout this guide are idealized designs that are not fully realized yet.
38+
All this makes keeping this guide completely up to date on everything very hard!
39+
40+
The Guide itself is of course open-source as well, and the sources can be found at the [GitHub repository].
41+
If you find any mistakes in the guide, please file an issue about it, or even better, open a PR with a correction!
42+
43+
> “‘All conditioned things are impermanent’ — when one sees this with wisdom, one turns away from suffering.” _The Dhammapada, verse 277_
44+
3745

3846
## Other places to find information
3947

Diff for: src/overview.md

-12
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,6 @@ So first, let's look at what the compiler does to your code. For now, we will
1515
avoid mentioning how the compiler implements these steps except as needed;
1616
we'll talk about that later.
1717

18-
1918
- The compile process begins when a user writes a Rust source program in text
2019
and invokes the `rustc` compiler on it. The work that the compiler needs to
2120
perform is defined by command-line options. For example, it is possible to
@@ -159,17 +158,6 @@ satisfy/optimize for. For example,
159158
So, as you read through the rest of the guide, keep these things in mind. They
160159
will often inform decisions that we make.
161160

162-
### Constant change
163-
164-
Keep in mind that `rustc` is a real production-quality product.
165-
As such, it has its fair share of codebase churn and technical debt. A lot of
166-
the designs discussed throughout this guide are idealized designs that are not
167-
fully realized yet. And things keep changing so that it is hard to keep this
168-
guide completely up to date on everything!
169-
170-
The compiler definitely has rough edges, but because of its design it is able
171-
to keep up with the requirements above.
172-
173161
### Intermediate representations
174162

175163
As with most compilers, `rustc` uses some intermediate representations (IRs) to

Diff for: src/parallel-rustc.md

+4-3
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,10 @@
11
# Parallel Compilation
22

33
Most of the compiler is not parallel. This represents an opportunity for
4-
improving compiler performance. Much effort has been put into parallelizing
5-
`rustc`, but it is still pretty early days for this work. There is a lot of
6-
design and correctness work that needs to be done.
4+
improving compiler performance.
5+
6+
As of December 2020, work on explicitly parallelizing the compiler has stalled.
7+
There is a lot of design and correctness work that needs to be done.
78

89
One can try out the current parallel compiler work by enabling it in the
910
`config.toml`.

Diff for: src/the-parser.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
# Lexing and Parsing
22

3-
> The parser and lexer are currently undergoing a lot of refactoring, so parts
4-
> of this chapter may be out of date.
3+
As of January 2021, the lexer and parser are undergoing refactoring to allow
4+
extracting them into libraries.
55

66
The very first thing the compiler does is take the program (in Unicode
77
characters) and turn it into something the compiler can work with more

Diff for: src/traits/lowering-module.md

-3
This file was deleted.

0 commit comments

Comments
 (0)