Merge pull request matplotlib#31818 from timhoffm/mnt-deprecate-recache_always

MNT: Deprecate Line2D.recache_always()

Author: QuLogic

doc/api/next_api_changes/deprecations/31818-TH.rst

@@ -0,0 +1,4 @@
+Line2D.recache_always
+~~~~~~~~~~~~~~~~~~~~~
+
+``recache_always()`` on `.Line2D` is deprecated. Use ``recache(always=True)`` instead.

lib/matplotlib/axes/_base.py

@@ -2652,7 +2652,7 @@ def _unit_change_handler(self, axis_name, event=None):
                 self._unit_change_handler, axis_name, event=object())
         _api.check_in_list(self._axis_map, axis_name=axis_name)
         for line in self.lines:
-            line.recache_always()
+            line.recache(always=True)
         self.relim()
         self._request_autoscale_view(axis_name)
 

lib/matplotlib/lines.py

@@ -669,6 +669,7 @@ def set_data(self, *args):
         self.set_xdata(x)
         self.set_ydata(y)
 
+    @_api.deprecated("3.12", alternative="recache(always=True)")
     def recache_always(self):
         self.recache(always=True)