doc handling of code gone stale...

diff --git a/docs/sandbox/readme-sandbox.html b/docs/sandbox/readme-sandbox.html
index d5757ef579a5da784c32c3d748b921ff106d1d3e..e8353988275e9b3e0bf90ce20190bf1a729395ef 100644 (file)
--- a/docs/sandbox/readme-sandbox.html
+++ b/docs/sandbox/readme-sandbox.html
@@ -207,6 +207,18 @@ and before samples are extracted.
        </li>
 </ul>
 
+If the code is broken (e.g., if it no longer works in the latest
+version of AspectJ), then prefix SAMPLE with BROKEN in the tag:
+
+<pre>
+  {comment} START-<skipParse/>BROKEN-SAMPLE ...
+  ... sample code ...
+  {comment} END-<skipParse/>BROKEN-SAMPLE ...
+  ... more text ...
+</pre>
+
+It will no longer be gathered, but can be fixed and reinstated.
+
 <p>
 Happy coding!
 <hr>