Merge tag 'debian/1.52.1+dfsg1-1_exp2' into proxmox/buster

[rustc.git] / src / doc / rustc-dev-guide / src / syntax-intro.md

diff --git a/src/doc/rustc-dev-guide/src/syntax-intro.md b/src/doc/rustc-dev-guide/src/syntax-intro.md
index dd7e2d7359408b676326cdd7a46a950c613596d7..43ef44577466824e2fd3c34cb9d8e0f42110f66a 100644 (file)
--- 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.