Merge pull request #19002 from dopplershift/locator-note

QuLogic · web-flow · commit e780592430df · 2020-12-16T20:16:11.000-05:00
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
 ---------------
 
