Merge pull request #7117 from NelleV/hkucukdereli_doc_update_fix

NelleV · tacaswell · commit a40cad4f2218 · 2016-09-15T22:59:22.000-04:00
Step function docstring is now in numpydoc.
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
@@ -1808,28 +1808,36 @@ def step(self, x, y, *args, **kwargs):
         """
         Make a step plot.
 
-        Call signature::
-
-          step(x, y, *args, **kwargs)
-
-        Additional keyword args to :func:`step` are the same as those
-        for :func:`~matplotlib.pyplot.plot`.
+        Parameters
+        ----------
+        x : array_like
+            1-D sequence, and it is assumed, but not checked,
+            that it is uniformly increasing.
 
-        *x* and *y* must be 1-D sequences, and it is assumed, but not checked,
-        that *x* is uniformly increasing.
+        y : array_like
+            1-D sequence, and it is assumed, but not checked,
+            that it is uniformly increasing.
 
-        Keyword arguments:
+        Returns
+        -------
+        list
+            List of lines that were added.
 
-        *where*: [ 'pre' | 'post' | 'mid'  ]
-          If 'pre' (the default), the interval from x[i] to x[i+1] has level
-          y[i+1].
+        Other parameters
+        ----------------
+        where : [ 'pre' | 'post' | 'mid'  ]
+            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.
+            If 'mid', the jumps in *y* occur half-way between the
+            *x*-values.
 
-        Return value is a list of lines that were added.
+        Notes
+        -----
+        Additional parameters are the same as those for
+        :func:`~matplotlib.pyplot.plot`.
         """
 
         where = kwargs.pop('where', 'pre')
