Merge pull request #20065 from anntzer/atf

dstansby · web-flow · commit a08e334c1201 · 2021-04-25T10:44:27.000+01:00
Deprecate AxesDivider.append_axes(..., add_to_figure=True).
diff --git a/doc/api/next_api_changes/deprecations/20065-AL.rst b/doc/api/next_api_changes/deprecations/20065-AL.rst
@@ -0,0 +1,4 @@
+``AxesDivider.append_axes(..., add_to_figure=False)``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+... is deprecated.  Use ``ax.remove()`` to remove the Axes from the figure if
+needed.
diff --git a/lib/mpl_toolkits/axes_grid1/axes_divider.py b/lib/mpl_toolkits/axes_grid1/axes_divider.py
@@ -525,6 +525,7 @@ def new_vertical(self, size, pad=None, pack_start=False, **kwargs):
         ax.set_axes_locator(locator)
         return ax
 
+    @_api.delete_parameter("3.5", "add_to_figure", alternative="ax.remove()")
     def append_axes(self, position, size, pad=None, add_to_figure=True,
                     **kwargs):
         """
