Skip to content

Commit 5317005

Browse files
committed
minor edits
1 parent cba023d commit 5317005

File tree

1 file changed

+12
-13
lines changed

1 file changed

+12
-13
lines changed

src/syntax-intro.md

+12-13
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,19 @@
11
# Syntax and the AST
22

3-
Working directly with source code is very inconvenient and error-prone. Thus,
4-
before we do anything else, we convert raw source code into an [Abstract Syntax
5-
Tree (`AST`)][`AST`]. It turns out that doing even this involves a lot of work,
6-
including [lexing, parsing], [`macro` expansion], [name resolution], conditional
7-
compilation, [feature-gate checking], and [validation] of the [`AST`]. In this chapter,
8-
we take a look at all of these steps.
3+
Working directly with source code is very inconvenient and error-prone.
4+
Thus, before we do anything else, we convert raw source code into an
5+
[Abstract Syntax Tree (AST)][AST]. It turns out that doing this involves a lot of work,
6+
including [lexing, parsing], [macro expansion], [name resolution], conditional
7+
compilation, [feature-gate checking], and [validation] of the [AST].
8+
In this chapter, we take a look at all of these steps.
99

10-
Notably, there isn't always a clean ordering between these tasks. For example,
11-
`macro` expansion relies on name resolution to resolve the names of `macro`s and
12-
imports. And parsing requires `macro` expansion, which in turn may require
13-
parsing the output of the `macro`.
10+
Notably, there isn't always a clean ordering between these tasks.
11+
For example, macro expansion relies on name resolution to resolve the names of macros and imports.
12+
And parsing requires macro expansion, which in turn may require parsing the output of the macro.
1413

15-
[`AST`]: https://doc.rust-lang.org/nightly/nightly-rustc/rustc_parse/index.html
16-
[`macro` expansion]: ./macro-expansion.md
14+
[AST]: https://doc.rust-lang.org/nightly/nightly-rustc/rustc_parse/index.html
15+
[macro expansion]: ./macro-expansion.md
1716
[feature-gate checking]: ./feature-gate-ck.md
1817
[lexing, parsing]: ./lexing-parsing.md
1918
[name resolution]: ./name-resolution.md
20-
[validation]: ./ast-validation.md
19+
[validation]: ./ast-validation.md

0 commit comments

Comments
 (0)