Deprecate update_datalim_bounds.

anntzer · anntzer · commit 0013334630e7 · 2019-12-26T22:16:13.000+01:00
This method was introduced in 56d43e6 with a note that it would be more efficient to use it in some cases, then the note went away in ad74c3f (2008) without the method ever being used either before or after. In any case, it is simple enough to be reimplemented (possibly inline) if we really need it.
diff --git a/doc/api/next_api_changes/deprecations.rst b/doc/api/next_api_changes/deprecations.rst
@@ -73,3 +73,8 @@ Revert deprecation \*min, \*max keyword arguments to ``set_x/y/zlim_3d()``
 These keyword arguments  were deprecated in 3.0, alongside with the respective
 parameters in ``set_xlim()`` / ``set_ylim()``. The deprecations of the 2D
 versions were already reverted in in 3.1.
+
+``Axes.update_datalim_bounds``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+This method is deprecated.  Use
+``ax.dataLim.set(Bbox.union([ax.dataLim, bounds]))`` instead.
diff --git a/lib/matplotlib/axes/_base.py b/lib/matplotlib/axes/_base.py
@@ -2099,6 +2099,8 @@ def update_datalim(self, xys, updatex=True, updatey=True):
                                          updatex=updatex, updatey=updatey)
         self.ignore_existing_data_limits = False
 
+    @cbook.deprecated(
+        "3.3", alternative="ax.dataLim.set(Bbox.union([ax.dataLim, bounds]))")
     def update_datalim_bounds(self, bounds):
         """
         Extend the `~.Axes.datalim` Bbox to include the given
