Fix doc for set_{x,y}label, and then some more.

anntzer · anntzer · commit e141beca34a0 · 2020-02-15T10:48:19.000+01:00
The previous wording of the "see also: text" was a bit confused.  As it
turns out `text()` doesn't actually list the supported properties, but
if there's *one* axes method where it makes sense to list them, it's
there... (I don't think set_xlabel needs to dupe the list of properties;
a "see also: text" seems enough.)
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
@@ -213,7 +213,7 @@ def set_xlabel(self, xlabel, fontdict=None, labelpad=None, *,
 
         See also
         --------
-        text : for information on how override and the optional arguments work
+        text : Documents the properties supported by `.Text`.
         """
         if labelpad is not None:
             self.xaxis.labelpad = labelpad
@@ -266,7 +266,7 @@ def set_ylabel(self, ylabel, fontdict=None, labelpad=None, *,
 
         See also
         --------
-        text : for information on how override and the optional arguments work
+        text : Documents the properties supported by `.Text`.
         """
         if labelpad is not None:
             self.yaxis.labelpad = labelpad
@@ -689,6 +689,7 @@ def secondary_yaxis(self, location, *, functions=None, **kwargs):
             raise ValueError('secondary_yaxis location must be either '
                              'a float or "left"/"right"')
 
+    @docstring.dedent_interpd
     def text(self, x, y, s, fontdict=None, **kwargs):
         """
         Add text to the axes.
@@ -719,6 +720,8 @@ def text(self, x, y, s, fontdict=None, **kwargs):
         **kwargs : `~matplotlib.text.Text` properties.
             Other miscellaneous text parameters.
 
+            %(Text)s
+
         Examples
         --------
         Individual keyword arguments can be used to override any given
diff --git a/lib/matplotlib/axes/_secondary_axes.py b/lib/matplotlib/axes/_secondary_axes.py
@@ -316,7 +316,7 @@ def set_xlabel(self, xlabel, fontdict=None, labelpad=None, **kwargs):
 
         See also
         --------
-        text : for information on how override and the optional args work
+        text : Documents the properties supported by `.Text`.
         """
         if labelpad is not None:
             self.xaxis.labelpad = labelpad
@@ -341,7 +341,7 @@ def set_ylabel(self, ylabel, fontdict=None, labelpad=None, **kwargs):
 
         See also
         --------
-        text : for information on how override and the optional args work
+        text : Documents the properties supported by `.Text`.
         """
         if labelpad is not None:
             self.yaxis.labelpad = labelpad
