Skip to content

Commit f8c1fe6

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

File tree

6 files changed

+21
-20
lines changed

6 files changed

+21
-20
lines changed

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)

src/about-this-guide.md

+15
Original file line numberDiff line numberDiff line change
@@ -35,6 +35,21 @@ be found at the [GitHub repository]. If you find any mistakes in the
3535
guide, please file an issue about it, or even better, open a PR
3636
with a correction!
3737

38+
### Constant change
39+
40+
Keep in mind that `rustc` is a real production-quality product, being worked upon continuously by a sizeable set of contributors.
41+
As such, it has its fair share of codebase churn and technical debt.
42+
In addition, many of the ideas discussed throughout this guide are idealized designs that are not fully realized yet.
43+
44+
And things keep changing so that it is
45+
46+
making hard to keep this guide completely up to date on everything!
47+
48+
Contributing to this guide:
49+
50+
> “‘All conditioned things are impermanent’ — when one sees this with wisdom, one turns away from suffering.” _The Dhammapada, verse 277_
51+
52+
3853
## Other places to find information
3954

4055
You might also find the following sites useful:

src/overview.md

-11
Original file line numberDiff line numberDiff line change
@@ -159,17 +159,6 @@ satisfy/optimize for. For example,
159159
So, as you read through the rest of the guide, keep these things in mind. They
160160
will often inform decisions that we make.
161161

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-
173162
### Intermediate representations
174163

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

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`.

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

src/traits/lowering-module.md

-3
This file was deleted.

0 commit comments

Comments
 (0)