DOC didn't render properly

NelleV · NelleV · commit 0de3de8e9f46 · 2013-02-28T15:57:52.000+01:00
diff --git a/lib/matplotlib/axes.py b/lib/matplotlib/axes.py
@@ -3660,10 +3660,10 @@ def hlines(self, y, xmin, xmax, colors='k', linestyles='solid',
 
         Parameters
         ----------
-        y : scalar or 1D array like
+        y : scalar or 1D array_like
             y-indexes where to plot the lines.
 
-        xmin, xmax : scalar or 1D array like
+        xmin, xmax : scalar or 1D array_like
             Respective beginning and end of each line. If scalars are
             provided, all lines will have same length.
 
@@ -3675,19 +3675,20 @@ def hlines(self, y, xmin, xmax, colors='k', linestyles='solid',
 
         Returns
         -------
-        matplotlib.collections.LineCollection
+        lines : `~matplotlib.collections.LineCollection`
 
         Other parameters
         ----------------
-        kwargs correspond to matplotlib.collections.LineCollection properties.
-
-        Notes
-        -----
-        .. plot:: mpl_examples/pylab_examples/vline_hline_demo.py
+        kwargs :  `~matplotlib.collections.LineCollection` properties.
 
         See also
         --------
         vlines : vertical lines
+
+        Examples
+        --------
+        .. plot:: mpl_examples/pylab_examples/vline_hline_demo.py
+
         """
 
         # We do the conversion first since not all unitized data is uniform
@@ -3748,10 +3749,10 @@ def vlines(self, x, ymin, ymax, colors='k', linestyles='solid',
 
         Parameters
         ----------
-        x : scalar or 1D array like
+        x : scalar or 1D array_like
             x-indexes where to plot the lines.
 
-        xmin, xmax : scalar or 1D array like
+        xmin, xmax : scalar or 1D array_like
             Respective beginning and end of each line. If scalars are
             provided, all lines will have same length.
 
@@ -3763,20 +3764,20 @@ def vlines(self, x, ymin, ymax, colors='k', linestyles='solid',
 
         Returns
         -------
-        matplotlib.collections.LineCollection
+        lines : `~matplotlib.collections.LineCollection`
 
         Other parameters
         ----------------
-        kwargs correspond to matplotlib.collections.LineCollection properties.
-
-        Notes
-        -----
-        .. plot:: mpl_examples/pylab_examples/vline_hline_demo.py
+        kwargs : `~matplotlib.collections.LineCollection` properties.
 
         See also
         --------
         hlines : horizontal lines
 
+        Examples
+        ---------
+        .. plot:: mpl_examples/pylab_examples/vline_hline_demo.py
+
         """
 
         self._process_unit_info(xdata=x, ydata=[ymin, ymax], kwargs=kwargs)
