DOC sticky edges now uses numpydoc

NelleV · NelleV · commit 1a86b08fbc07 · 2016-12-01T10:39:29.000-08:00
diff --git a/lib/matplotlib/artist.py b/lib/matplotlib/artist.py
@@ -931,19 +931,22 @@ def set_zorder(self, level):
     @property
     def sticky_edges(self):
         """
-        The `x` and `y` sticky edge lists for the artist.
+        `x` and `y` sticky edge lists.
 
-        When autoscaling, if a data limit coincides with a value
-        in the corresponding sticky_edges list, then no margin
-        will be added--the view limit "sticks" to the edge.
+        When performing autoscaling, if a data limit coincides with a value in
+        the corresponding sticky_edges list, then no margin will be added--the
+        view limit "sticks" to the edge. A typical usecase is histograms,
+        where one usually expects no margin on the bottom edge (0) of the
+        histogram.
 
         This attribute cannot be assigned to; however, the `x` and `y` lists
         can be modified in place as needed.
 
-        Example usage::
+        Examples
+        --------
 
-            artist.sticky_edges.x[:] = (xmin, xmax)
-            artist.sticky_edges.y[:] = (ymin, ymax)
+        >>> artist.sticky_edges.x[:] = (xmin, xmax)
+        >>> artist.sticky_edges.y[:] = (ymin, ymax)
 
         """
         return self._sticky_edges
