Backport PR #12914: Fix numpydoc formatting

dstansby · timhoffm · commit adde5e2bcdc7 · 2018-12-06T00:06:31.000+01:00
diff --git a/lib/matplotlib/colorbar.py b/lib/matplotlib/colorbar.py
@@ -166,10 +166,9 @@
 
 Returns
 -------
-:class:`~matplotlib.colorbar.Colorbar` instance
-    See also its base class, :class:`~matplotlib.colorbar.ColorbarBase`.
-    Call the :meth:`~matplotlib.colorbar.ColorbarBase.set_label` method
-    to label the colorbar.
+colorbar : `~matplotlib.colorbar.Colorbar`
+    See also its base class, `~matplotlib.colorbar.ColorbarBase`.  Use
+    `~.ColorbarBase.set_label` to label the colorbar.
 
 Notes
 -----
