Merge pull request #22064 from StefRe/doc/set_title

timhoffm · web-flow · commit 88ea09b2a4e5 · 2021-12-29T22:08:57.000+01:00
DOC: Clarify y parameter in Axes.set_title
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
@@ -119,8 +119,8 @@ def set_title(self, label, fontdict=None, loc=None, pad=None, *, y=None,
 
         y : float, default: :rc:`axes.titley`
             Vertical Axes loation for the title (1.0 is the top).  If
-            None (the default), y is determined automatically to avoid
-            decorators on the Axes.
+            None (the default) and :rc:`axes.titley` is also None, y is
+            determined automatically to avoid decorators on the Axes.
 
         pad : float, default: :rc:`axes.titlepad`
             The offset of the title from the top of the Axes, in points.
