small-doc-improvements1

ImportanceOfBeingErnest · ImportanceOfBeingErnest · commit 9657378bf267 · 2018-05-02T17:35:31.000+02:00
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
@@ -499,7 +499,7 @@ def axhline(self, y=0, xmin=0, xmax=1, **kwargs):
 
         Returns
         -------
-        :class:`~matplotlib.lines.Line2D`
+        line : :class:`~matplotlib.lines.Line2D`
 
         Other Parameters
         ----------------
@@ -569,7 +569,7 @@ def axvline(self, x=0, ymin=0, ymax=1, **kwargs):
 
         Returns
         -------
-        :class:`~matplotlib.lines.Line2D`
+        line : :class:`~matplotlib.lines.Line2D`
 
         Other Parameters
         ----------------
@@ -964,8 +964,9 @@ def eventplot(self, positions, orientation='horizontal', lineoffsets=1,
         Returns
         -------
 
-        A list of :class:`matplotlib.collections.EventCollection` objects that
-        were added.
+        list : A list of :class:`~.collections.EventCollection` objects.
+            Contains the :class:`~.collections.EventCollection` that
+            were added.
 
         Notes
         -----
@@ -1849,7 +1850,7 @@ def bar(self, x, height, width=0.8, bottom=None, *, align="center",
 
         Returns
         -------
-        `.BarContainer`
+        BarContainer : `.BarContainer`
             Container with all the bars and optionally errorbars.
 
         Other Parameters
@@ -1873,7 +1874,9 @@ def bar(self, x, height, width=0.8, bottom=None, *, align="center",
 
             - scalar: symmetric +/- values for all bars
             - shape(N,): symmetric +/- values for each bar
-            - shape(2,N): separate + and - values for each bar
+            - shape(2,N): Separate - and + values for each bar. First row
+                contains the lower errors, the second row contains the
+                upper errors.
 
             Default: None
 
@@ -2124,7 +2127,7 @@ def barh(self, y, width, height=0.8, left=None, *, align="center",
 
         Returns
         -------
-        `.BarContainer`
+        BarContainer : `.BarContainer`
             Container with all the bars and optionally errorbars.
 
         Other Parameters
@@ -2148,7 +2151,9 @@ def barh(self, y, width, height=0.8, left=None, *, align="center",
 
             - scalar: symmetric +/- values for all bars
             - shape(N,): symmetric +/- values for each bar
-            - shape(2,N): separate + and - values for each bar
+            - shape(2,N): Separate - and + values for each bar. First row
+                contains the lower errors, the second row contains the
+                upper errors.
 
             Default: None
 
@@ -2235,7 +2240,7 @@ def broken_barh(self, xranges, yrange, **kwargs):
 
         Returns
         -------
-        :class:`matplotlib.collections.BrokenBarHCollection`
+        BrokenBarHCollection : A :class:`~.collections.BrokenBarHCollection`
 
         Notes
         -----
@@ -2671,7 +2676,9 @@ def errorbar(self, x, y, yerr=None, xerr=None,
 
             - scalar: Symmetric +/- values for all data points.
             - shape(N,): Symmetric +/-values for each data point.
-            - shape(2,N): Separate + and - values for each data point.
+            - shape(2,N): Separate - and + values for each bar. First row
+                contains the lower errors, the second row contains the
+                upper errors.
             - *None*: No errorbar.
 
         fmt : plot format string, optional, default: ''
@@ -2719,7 +2726,7 @@ def errorbar(self, x, y, yerr=None, xerr=None,
 
         Returns
         -------
-        :class:`~.container.ErrorbarContainer`
+        ErrorbarContainer : :class:`~.container.ErrorbarContainer`
             The container contains:
 
             - plotline: :class:`~matplotlib.lines.Line2D` instance of
diff --git a/lib/matplotlib/stackplot.py b/lib/matplotlib/stackplot.py
@@ -53,7 +53,7 @@ def stackplot(axes, x, *args,
 
     Returns
     -------
-    list of `.PolyCollection`
+    list : list of `.PolyCollection`
         A list of `.PolyCollection` instances, one for each element in the
         stacked area plot.
     """
