added some additional comments to axes to clarify the patch/frame relationship

jdh2358 · jdh2358 · commit 46fe600f8b58 · 2008-07-28T16:42:10.000Z
svn path=/trunk/matplotlib/; revision=5912
diff --git a/lib/matplotlib/axes.py b/lib/matplotlib/axes.py
@@ -1451,6 +1451,8 @@ def draw(self, renderer=None, inframe=False):
 
         self.apply_aspect(self.get_position(True))
 
+        # the patch draws the background rectangle -- the frame below
+        # will draw the edges
         if self.axison and self._frameon:
             self.patch.draw(renderer)
 
@@ -1506,6 +1508,9 @@ def draw(self, renderer=None, inframe=False):
         if self.legend_ is not None:
             artists.append(self.legend_)
 
+        # the frame draws the edges around the axes patch -- we
+        # decouple these so the patch can be in the background and the
+        # frame in the foreground.
         if self.axison and self._frameon:
             artists.append(self.frame)
 
