Fix doc build

dstansby · dstansby · commit 3cac065ff661 · 2017-12-31T18:54:56.000Z
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
@@ -1737,40 +1737,41 @@ def xcorr(self, x, y, normed=True, detrend=mlab.detrend_none,
 
         y : sequence of scalars of length n
 
-        hold : boolean, optional, *deprecated*, default: True
+        hold : bool, optional, *deprecated*, default: True
 
         detrend : callable, optional, default: `mlab.detrend_none`
             *x* is detrended by the *detrend* callable. Default is no
             normalization.
 
-        normed : boolean, optional, default: True
+        normed : bool, optional, default: True
             If ``True``, input vectors are normalised to unit length.
 
-        usevlines : boolean, optional, default: True
+        usevlines : bool, optional, default: True
             If ``True``, `Axes.vlines` is used to plot the vertical lines from
             the origin to the acorr. Otherwise, `Axes.plot` is used.
 
-        maxlags : integer, optional, default: 10
+        maxlags : int, optional
             Number of lags to show. If None, will return all ``2 * len(x) - 1``
-            lags.
+            lags. Default is 10.
 
         Returns
         -------
         tuple
             (lags, c, line, b) : where:
 
               - *lags* are a length ``2*maxlags+1`` lag vector.
-              - *c* is the length ``2*maxlags+1` auto correlation vector.
+              - *c* is the length ``2*maxlags+1`` auto correlation vector.
               - *line* is a `~matplotlib.lines.Line2D` instance returned by
                 `plot`.
               - *b* is the x-axis (none, if plot is used).
 
         Other Parameters
         ----------------
-        linestyle : `~matplotlib.lines.Line2D` prop, optional, default: None
+        linestyle : `~matplotlib.lines.Line2D` property, optional
             Only used if usevlines is ``False``.
 
-        marker : string, optional, default: 'o'
+        marker : string, optional
+            Default is 'o'.
 
         Notes
         -----
@@ -5584,7 +5585,7 @@ def pcolormesh(self, *args, **kwargs):
             scale luminance data to 0,1. If ``None``, defaults to
             :func:`normalize`.
 
-        vmin, vmax: scalar, optional
+        vmin, vmax : scalar, optional
             *vmin* and *vmax* are used in conjunction with *norm* to
             normalize luminance data. If either is ``None``, it is autoscaled
             to the respective min or max of the color array *C*.
@@ -5596,36 +5597,33 @@ def pcolormesh(self, *args, **kwargs):
             'gouraud', each quad will be Gouraud shaded. When gouraud
             shading, *edgecolors* is ignored.
 
-        edgecolors : [*None* | ``'None'`` | ``'face'`` | color |
-                         color sequence], optional
-            If ``None``, the rc setting is used by default.
-
-            If ``'None'``, edges will not be visible.
+        edgecolors : string, color, color sequence, optional
+            - If ``None``, the rc setting is used by default.
+            - If ``'None'``, edges will not be visible.
+            - If ``'face'``, edges will have the same color as the faces.
 
-            If ``'face'``, edges will have the same color as the faces.
-
-            An mpl color or sequence of colors will set the edge color
+            An mpl color or sequence of colors will also set the edge color.
 
         alpha : scalar, optional
             Alpha blending value. Must be between 0 and 1.
 
         Returns
         -------
-        :class:`matplotlib.collections.QuadMesh`
+        matplotlib.collections.QuadMesh
+
+        See Also
+        --------
+        matplotlib.pyplot.pcolor :
+            For an explanation of the grid orientation
+            (:ref:`Grid Orientation <axes-pcolor-grid-orientation>`)
+            and the expansion of 1-D *X* and/or *Y* to 2-D arrays.
 
         Notes
         -----
         kwargs can be used to control the
         :class:`matplotlib.collections.QuadMesh` properties:
 
         %(QuadMesh)s
-
-        See also
-        --------
-        :func:`~matplotlib.pyplot.pcolor` :
-                For an explanation of the grid orientation
-                (:ref:`Grid Orientation <axes-pcolor-grid-orientation>`)
-                and the expansion of 1-D *X* and/or *Y* to 2-D arrays.
         """
         if not self._hold:
             self.cla()
