Merge pull request #19136 from meeseeksmachine/auto-backport-of-pr-19002-on-v3.3.3-doc

timhoffm · web-flow · commit 710ffd94247e · 2020-12-17T11:25:38.000+01:00
Backport PR #19002 on branch v3.3.3-doc (DOC: Add note about locators at top of ticker docs)
diff --git a/lib/matplotlib/ticker.py b/lib/matplotlib/ticker.py
@@ -81,6 +81,19 @@
 
 The default minor locator is `NullLocator`, i.e., no minor ticks on by default.
 
+.. note::
+    `Locator` instances should not be used with more than one
+    `~matplotlib.axis.Axis` or `~matplotlib.axes.Axes`. So instead of::
+
+        locator = MultipleLocator(5)
+        ax.xaxis.set_major_locator(locator)
+        ax2.xaxis.set_major_locator(locator)
+
+    do the following instead::
+
+        ax.xaxis.set_major_locator(MultipleLocator(5))
+        ax2.xaxis.set_major_locator(MultipleLocator(5))
+
 Tick formatting
 ---------------
 
