docstring for mbe module

1 files changed, 5 insertions, 0 deletions

diff --git a/src/libsyntax/ext/mbe.rs b/src/libsyntax/ext/mbe.rs
index b77b59fea70..78d96f471fa 100644
--- a/src/libsyntax/ext/mbe.rs
+++ b/src/libsyntax/ext/mbe.rs
@@ -1,3 +1,8 @@
+//! This module implements declarative macros: old `macro_rules` and the newer
+//! `macro`. Declarative macros are also known as "macro by example", and that's
+//! why we call this module `mbe`. For external documentation, prefer the
+//! official terminology: "declarative macros".
+
 crate mod transcribe;
 crate mod macro_check;
 crate mod macro_parser;