update step function documentation

hkucukdereli · NelleV · commit 22b79d33df74 · 2016-09-15T09:00:23.000-07:00
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
@@ -1810,19 +1810,24 @@ 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
+        -------
+        out : list
+            List of lines that were added.
 
-        *where*: [ 'pre' | 'post' | 'mid'  ]
+        Other parameters
+        ---------------------
+        where : [ 'pre' | 'post' | 'mid'  ]
           If 'pre' (the default), the interval from x[i] to x[i+1] has level
           y[i+1].
 
@@ -1831,7 +1836,10 @@ def step(self, x, y, *args, **kwargs):
           If 'mid', the jumps in *y* occur half-way between the
           *x*-values.
 
-        Return value is a list of lines that were added.
+        Note
+        ----
+        Additional parameters are the same as those for :func:`~matplotlib.pyplot.plot`.
+
         """
 
         where = kwargs.pop('where', 'pre')
