Add a red-box warning to the macros guide

2 files changed, 14 insertions, 0 deletions

diff --git a/src/doc/guide-macros.md b/src/doc/guide-macros.md
index 83571b60d3a..50b2c281fcf 100644
--- a/src/doc/guide-macros.md
+++ b/src/doc/guide-macros.md
@@ -1,5 +1,14 @@
 % The Rust Macros Guide
 
+<div class="unstable-feature">
+<b>Warning:</b> There are currently various problems with invoking macros, how
+they interact with their environment, and how they are used outside of the
+location in which they are defined. Macro definitions are likely to change
+slightly in the future. For this reason, they are hidden behind the
+<code>macro_rules</code> <a href="reference.html#compiler-features">feature
+attribute</a>.
+</div>
+
 # Introduction
 
 Functions are the primary tool that programmers can use to build abstractions.
diff --git a/src/doc/rust.css b/src/doc/rust.css
index cf7e74e3430..22e360d2015 100644
--- a/src/doc/rust.css
+++ b/src/doc/rust.css
@@ -338,6 +338,11 @@ pre.rust { position: relative; }
     transform: scaleX(-1);
 }
 
+.unstable-feature {
+    border: 2px solid red;
+    padding: 5px;
+}
+
 @media (min-width: 1170px) {
     pre {
         font-size: 15px;