From 959de083eadfb63419737e4ea8c0b646d97f2aa0 Mon Sep 17 00:00:00 2001
From: Mark Pilgrim <mark@diveintomark.org>
Date: Mon, 13 Jul 2009 22:12:11 -0400
Subject: [PATCH] added sidebar about special methods

---
 dip3.css       | 10 +++++++++-
 iterators.html |  4 ++++
 2 files changed, 13 insertions(+), 1 deletion(-)
 mode change 100644 => 100755 dip3.css

diff --git a/dip3.css b/dip3.css
old mode 100644
new mode 100755
index a75b58d..6c70a30
--- a/dip3.css
+++ b/dip3.css
@@ -47,7 +47,7 @@ Classname Legend
 
 .note = "note/caution/important"   = indented block for tips/gotchas/language comparisons
 .baa  = "best available ampersand" = wrapper block for ampersands
-
+.ots  = "on the side"              = an aside that is set in normal type (as opposed to a big blue pullquote)
 
 Acknowledgements & Inspirations
 
@@ -283,6 +283,14 @@ aside {
   -webkit-border-radius: 1em;
   border-radius: 1em;
 }
+aside.ots {
+  font-style: normal;
+  font-size: medium;
+  line-height: 1.75;
+}
+aside a {
+  color: #fff !important;
+}
 
 /* previous/next navigation links */
 
diff --git a/iterators.html b/iterators.html
index 0f7795c..573c47b 100755
--- a/iterators.html
+++ b/iterators.html
@@ -158,6 +158,10 @@ body{counter-reset:h1 6}
 
 <p><em>Now</em> you&#8217;re ready to learn how to build an iterator. An iterator is just a class that defines an <code>__iter__()</code> method.
 
+<aside class=ots>
+All three of these class methods, <code>__init__</code>, <code>__iter__</code>, and <code>__next__</code>, begin and end with a pair of underscore (<code>_</code>) characters. Why is that? There&#8217;s nothing magical about it, but it usually indicates that these are &#8220;<dfn>special methods</dfn>.&#8221; The only thing &#8220;special&#8221; about special methods is that they aren&#8217;t called directly; Python calls them when you use some other syntax on the class or an instance of the class. <a href=special-method-names.html>More about special methods</a>.
+</aside>
+
 <p class=d>[<a href=examples/fibonacci2.py>download <code>fibonacci2.py</code></a>]
 <pre><code class=pp><a>class Fib:                                        <span class=u>&#x2460;</span></a>
 <a>    def __init__(self, max):                      <span class=u>&#x2461;</span></a>