DOC: update the overlapping tick docs

tacaswell · tacaswell · commit bc35d1310c12 · 2019-04-14T15:51:15.000-04:00
diff --git a/doc/api/prev_api_changes/api_changes_3.1.0.rst b/doc/api/prev_api_changes/api_changes_3.1.0.rst
@@ -108,10 +108,11 @@ with ``xaxis.major.locator()``, but ``xaxis.get_minorticklocs()`` does not.
 You can control this behavior via the ``.remove_overlap`` attribute on the
 minor locator.
 
-If you were relying on both the major and minor tick labels to appear on the
-same tick, you may need to update your code.  For example, the following
-snippet labeled days using major ticks, and hours and minutes using minor
-ticks::
+If you were relying on both the major and minor tick labels to appear
+on the same tick, you may need to update your code.  For example, the
+following snippet labeled days using major ticks, and hours and
+minutes using minor ticks and added a newline to the major ticks
+labels to avoid them crashing into the minor tick labels. ::
 
     import numpy as np
     import matplotlib.dates as mdates
@@ -128,12 +129,12 @@ ticks::
         minor_locator=mdates.HourLocator((0, 6, 12, 18)),
         minor_formatter=mdates.DateFormatter("%H:%M"),
     )
-    # disables tick collision suppression
-    ax.axis.minor.locator.remove_overlap = False
+    # disable removing overlapping ticks by adding this line
+    ax.xaxis.remove_overlapping_locs = False
     plt.show()
 
-and added a newline to the major ticks labels to avoid them crashing into the
-minor tick labels.
+Setting the `Axis.remove_overlapping_locs` property (also available
+via `Axis.set_remove_overlapping_locs` and `~pyplot.setp`).
 
 The major tick labels could also be adjusted include hours and
 minutes, as the minor ticks are gone, so the ``major_formatter``
