Merge pull request #16025 from anntzer/update_datalim_bounds

jklymak · web-flow · commit 3a2589bee0d7 · 2020-01-06T13:08:54.000-08:00
Deprecate update_datalim_bounds.
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
