Deprecate update_datalim_bounds.

anntzer · anntzer · commit 93edb74ab2fd · 2020-01-06T18:20:10.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
@@ -119,3 +119,8 @@ The following parameters do not have any effect and are deprecated:
 - parameter *quantize* of `.Path.cleaned()`
 - parameter *s* of `.AnnotationBbox.get_fontsize()`
 - parameter *label* of `.Tick`
+
+``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
