about summary refs log tree commit diff
path: root/src/doc/rustc-dev-guide
diff options
context:
space:
mode:
authormark <markm@cs.wisc.edu>2020-04-30 11:33:05 -0500
committerWho? Me?! <mark-i-m@users.noreply.github.com>2020-05-08 09:42:27 -0500
commit41c1e3d7f5077b26e1443b5db0f95c59b1cd0843 (patch)
treed97da5e47215820b7ca726c6d14348a3d5d8183e /src/doc/rustc-dev-guide
parent52ffc3edfcbef33f64b13b293d858955e93f2181 (diff)
downloadrust-41c1e3d7f5077b26e1443b5db0f95c59b1cd0843.tar.gz
rust-41c1e3d7f5077b26e1443b5db0f95c59b1cd0843.zip
add a bit to syntax intro
Diffstat (limited to 'src/doc/rustc-dev-guide')
-rw-r--r--src/doc/rustc-dev-guide/src/syntax-intro.md5
1 files changed, 5 insertions, 0 deletions
diff --git a/src/doc/rustc-dev-guide/src/syntax-intro.md b/src/doc/rustc-dev-guide/src/syntax-intro.md
index dd7e2d73594..43ef4457746 100644
--- a/src/doc/rustc-dev-guide/src/syntax-intro.md
+++ b/src/doc/rustc-dev-guide/src/syntax-intro.md
@@ -6,3 +6,8 @@ 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.
+
+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.