From 58c428fbf2df35bba9efe4290d63fa9df8aa9c20 Mon Sep 17 00:00:00 2001
From: Keegan McAllister <kmcallister@mozilla.com>
Date: Fri, 26 Sep 2014 12:52:37 -0700
Subject: [PATCH] Add a red-box warning to the macros guide

---
 src/doc/guide-macros.md | 9 +++++++++
 src/doc/rust.css        | 5 +++++
 2 files changed, 14 insertions(+)

diff --git a/src/doc/guide-macros.md b/src/doc/guide-macros.md
index 83571b60d3ae2..50b2c281fcf38 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 cf7e74e34301d..22e360d2015d6 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;