From 53170058d971e04cedc006ac50bf061b51717896 Mon Sep 17 00:00:00 2001 From: Noratrieb <48135649+Noratrieb@users.noreply.github.com> Date: Tue, 24 Sep 2024 20:21:01 +0200 Subject: [PATCH] minor edits --- src/syntax-intro.md | 25 ++++++++++++------------- 1 file changed, 12 insertions(+), 13 deletions(-) diff --git a/src/syntax-intro.md b/src/syntax-intro.md index 08798cad4..6339a7e6b 100644 --- a/src/syntax-intro.md +++ b/src/syntax-intro.md @@ -1,20 +1,19 @@ # Syntax and the AST -Working directly with source code is very inconvenient and error-prone. Thus, -before we do anything else, we convert raw source code into an [Abstract Syntax -Tree (`AST`)][`AST`]. It turns out that doing even this involves a lot of work, -including [lexing, parsing], [`macro` expansion], [name resolution], conditional -compilation, [feature-gate checking], and [validation] of the [`AST`]. In this chapter, -we take a look at all of these steps. +Working directly with source code is very inconvenient and error-prone. +Thus, before we do anything else, we convert raw source code into an +[Abstract Syntax Tree (AST)][AST]. It turns out that doing this involves a lot of work, +including [lexing, parsing], [macro expansion], [name resolution], conditional +compilation, [feature-gate checking], and [validation] of the [AST]. +In this chapter, we take a look at all of these steps. -Notably, there isn't always a clean ordering between these tasks. For example, -`macro` expansion relies on name resolution to resolve the names of `macro`s and -imports. And parsing requires `macro` expansion, which in turn may require -parsing the output of the `macro`. +Notably, there isn't always a clean ordering between these tasks. +For example, macro expansion relies on name resolution to resolve the names of macros and imports. +And parsing requires macro expansion, which in turn may require parsing the output of the macro. -[`AST`]: https://doc.rust-lang.org/nightly/nightly-rustc/rustc_parse/index.html -[`macro` expansion]: ./macro-expansion.md +[AST]: https://doc.rust-lang.org/nightly/nightly-rustc/rustc_parse/index.html +[macro expansion]: ./macro-expansion.md [feature-gate checking]: ./feature-gate-ck.md [lexing, parsing]: ./lexing-parsing.md [name resolution]: ./name-resolution.md -[validation]: ./ast-validation.md \ No newline at end of file +[validation]: ./ast-validation.md