Added hint to skip the heavy stuff on first reading.

diff --git a/Demo/metaclasses/index.html b/Demo/metaclasses/index.html
index 52d52e9fd01e520c0fc8ec75b9ed70a663c5094b..b87d2c2f292be088ddc787072d038c69c0c4f313 100644 (file)
--- a/Demo/metaclasses/index.html
+++ b/Demo/metaclasses/index.html
@@ -25,6 +25,15 @@ Beaudry <i>hack</i>,'' but that's a misnomer.  There's nothing hackish
 about it -- in fact, it is rather elegant and deep, even though
 there's something dark to it.)
 
+<P>(On first reading, you may want to skip directly to the examples in
+the section "Writing Metaclasses in Python" below, unless you want
+your head to explode.)  (XXX I should really restructure this document
+to place the historic notes last.  After 1.5a4 is released...)
+
+<P>
+
+<HR>
+
 <P>Documentation of the Don Beaudry hook has purposefully been kept
 minimal, since it is a feature of incredible power, and is easily
 abused.  Basically, it checks whether the <b>type of the base
@@ -148,6 +157,10 @@ HREF="http://maigret.cog.brown.edu/pyutil/">MESS</A> or <A
 HREF="http://www.digicool.com/papers/ExtensionClass.html" >Extension
 Classes</A> for more information.
 
+<P>
+
+<HR>
+
 <H2>Writing Metaclasses in Python</H2>
 
 <P>In Python 1.5, the requirement to write a C extension in order to
@@ -502,6 +515,8 @@ Synch module, and it would be interesting to add preconditions to it
 as well.  This needs more research.  Perhaps a metaclass could be
 provided that allows stackable wrappers...
 
+<P>
+
 <HR>
 
 <H2>Things You Could Do With Metaclasses</H2>