Merge pull request #21103 from meeseeksmachine/auto-backport-of-pr-21089-on-v3.5.x

timhoffm · web-flow · commit e6f36d8f4f26 · 2021-09-17T00:26:11.000+02:00
Backport PR #21089 on branch v3.5.x (Update sticky_edges docstring to new behavior.)
diff --git a/lib/matplotlib/artist.py b/lib/matplotlib/artist.py
@@ -1119,6 +1119,11 @@ def sticky_edges(self):
         where one usually expects no margin on the bottom edge (0) of the
         histogram.
 
+        Moreover, margin expansion "bumps" against sticky edges and cannot
+        cross them.  For example, if the upper data limit is 1.0, the upper
+        view limit computed by simple margin application is 1.2, but there is a
+        sticky edge at 1.1, then the actual upper view limit will be 1.1.
+
         This attribute cannot be assigned to; however, the ``x`` and ``y``
         lists can be modified in place as needed.
 
