Merge pull request matplotlib#16515 from anntzer/xylabeldoc

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

Author: timhoffm

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

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