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:36:47 -0500
committerWho? Me?! <mark-i-m@users.noreply.github.com>2020-05-08 09:42:27 -0500
commit9fa8ceeb1bf902ab0804d30c0445dea0987ef7aa (patch)
treef972e208b0d0f699cd4a9933dff53c20c83f5539 /src/doc/rustc-dev-guide
parent6b1f713d7296ed71ba2dfda32472f2e6a9fe7828 (diff)
downloadrust-9fa8ceeb1bf902ab0804d30c0445dea0987ef7aa.tar.gz
rust-9fa8ceeb1bf902ab0804d30c0445dea0987ef7aa.zip
add note about macros in parser chapter
Diffstat (limited to 'src/doc/rustc-dev-guide')
-rw-r--r--src/doc/rustc-dev-guide/src/the-parser.md5
1 files changed, 5 insertions, 0 deletions
diff --git a/src/doc/rustc-dev-guide/src/the-parser.md b/src/doc/rustc-dev-guide/src/the-parser.md
index c84ac4ea2e1..c0f2a071b53 100644
--- a/src/doc/rustc-dev-guide/src/the-parser.md
+++ b/src/doc/rustc-dev-guide/src/the-parser.md
@@ -38,6 +38,11 @@ To minimise the amount of copying that is done, both the `StringReader` and
 `Parser` have lifetimes which bind them to the parent `ParseSess`. This contains
 all the information needed while parsing, as well as the `SourceMap` itself.
 
+Note that while parsing, we may encounter macro definitions or invocations. We
+set these aside to be expanded (see [this chapter](./macro-expansion.md)).
+Expansion may itself require parsing the output of the macro, which may reveal
+more macros to be expanded, and so on.
+
 ## More on Lexical Analysis
 
 Code for lexical analysis is split between two crates: