Deprecate update_datalim_bounds.

anntzer · anntzer · commit cfa859eebb20 · 2020-01-05T23:05:21.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
@@ -110,3 +110,8 @@ them.
 ``args_key`` and ``exec_key`` attributes of builtin `.MovieWriter`\s
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 These attributes are deprecated.
+
+``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
