Minor doc cleanups

timhoffm · timhoffm · commit eed5ab24b1f5 · 2019-12-16T00:37:38.000+01:00
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
@@ -970,11 +970,12 @@ def axhspan(self, ymin, ymax, xmin=0, xmax=1, **kwargs):
 
         Returns
         -------
-        Polygon : `~matplotlib.patches.Polygon`
+        rectangle : `~matplotlib.patches.Polygon`
+            Horizontal span (rectangle) from (xmin, ymin) to (xmax, ymax).
 
         Other Parameters
         ----------------
-        **kwargs : `~matplotlib.patches.Polygon` properties.
+        **kwargs : `~matplotlib.patches.Polygon` properties
 
         %(Polygon)s
 
@@ -1027,8 +1028,9 @@ def axvspan(self, xmin, xmax, ymin=0, ymax=1, **kwargs):
 
         Other Parameters
         ----------------
-        **kwargs
-            Optional parameters are properties of the class `.Polygon`.
+        **kwargs : `~matplotlib.patches.Polygon` properties
+
+        %(Polygon)s
 
         See Also
         --------
@@ -6134,7 +6136,7 @@ def pcolorfast(self, *args, alpha=None, norm=None, cmap=None, vmin=None,
 
           ax.pcolorfast([X, Y], C, /, **kwargs)
 
-        This method is similar to ~.Axes.pcolor` and `~.Axes.pcolormesh`.
+        This method is similar to `~.Axes.pcolor` and `~.Axes.pcolormesh`.
         It's designed to provide the fastest pcolor-type plotting with the
         Agg backend. To achieve this, it uses different algorithms internally
         depending on the complexity of the input grid (regular rectangular,
@@ -7470,8 +7472,8 @@ def specgram(self, x, NFFT=None, Fs=None, Fc=None, detrend=None,
             of the bins is smaller than those of the segments.
 
         **kwargs
-            Additional keyword arguments are passed on to imshow which makes
-            the specgram image.
+            Additional keyword arguments are passed on to `~.axes.Axes.imshow`
+            which makes the specgram image.
 
         Returns
         -------
