Deprecate axis3d.Axis.get_tick_positions.

anntzer · anntzer · commit 28fb185af97b · 2019-02-06T01:07:24.000+01:00
See changelog entry for rationale.
diff --git a/doc/api/next_api_changes/2018-02-06-AL.rst b/doc/api/next_api_changes/2018-02-06-AL.rst
@@ -0,0 +1,7 @@
+Deprecations
+````````````
+
+``axis3d.Axis.get_tick_positions`` is deprecated.  It has never been used
+internally, no equivalent method exists on the 2D Axis classes, and, despite
+the similar name, it has a completely different behavior from the 2D Axis'
+`axis.Axis.get_ticks_position` method.
diff --git a/lib/mpl_toolkits/mplot3d/axis3d.py b/lib/mpl_toolkits/mplot3d/axis3d.py
@@ -7,7 +7,8 @@
 import numpy as np
 
 from matplotlib import (
-    artist, lines as mlines, axis as maxis, patches as mpatches, rcParams)
+    artist, cbook, lines as mlines, axis as maxis, patches as mpatches,
+    rcParams)
 from . import art3d, proj3d
 
 
@@ -133,6 +134,7 @@ def init3d(self):
         self.label._transform = self.axes.transData
         self.offsetText._transform = self.axes.transData
 
+    @cbook.deprecated("3.1")
     def get_tick_positions(self):
         majorLocs = self.major.locator()
         self.major.formatter.set_locs(majorLocs)
