Merge pull request #4471 from anntzer/step-docstring

tacaswell · tacaswell · commit 2ac9ac24bbec · 2015-05-25T18:21:59.000-04:00
DOC: Minor improvements to the docstring of `step`.
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
@@ -1790,12 +1790,15 @@ def step(self, x, y, *args, **kwargs):
         Keyword arguments:
 
         *where*: [ 'pre' | 'post' | 'mid'  ]
-          If 'pre', the interval from x[i] to x[i+1] has level y[i+1]
+          If 'pre' (the default), the interval from x[i] to x[i+1] has level
+          y[i+1].
 
-          If 'post', that interval has level y[i]
+          If 'post', that interval has level y[i].
 
           If 'mid', the jumps in *y* occur half-way between the
           *x*-values.
+
+        Return value is a list of lines that were added.
         """
 
         where = kwargs.pop('where', 'pre')
