Add a red-box warning to the macros guide

diff --git a/src/doc/guide-macros.md b/src/doc/guide-macros.md
index 83571b60d3ae2e829a41a401f9aa3ee0db75afe0..50b2c281fcf38a49c2f5ecf9b3e1bfe4389fedd4 100644 (file)
--- 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 cf7e74e34301d1bd0eb3290debe47d004184f38b..22e360d2015d6ccc69b7c657106610188b48fd1f 100644 (file)
--- 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;