From 17f08ed9d822bb4dfcbf41f15d1c5ce67c254ab4 Mon Sep 17 00:00:00 2001 From: Elliott Sales de Andrade Date: Wed, 7 Sep 2022 01:54:03 -0400 Subject: [PATCH] Consolidate API deprecations for 3.6 --- .../deprecations/16931-AL.rst | 11 - .../deprecations/20071-AL.rst | 5 - .../deprecations/20839-EP.rst | 4 - .../deprecations/20995-AL.rst | 3 - .../deprecations/21056-AL.rst | 3 - .../deprecations/21187-AL.rst | 3 - .../deprecations/21356-AL.rst | 5 - .../deprecations/21412-AL.rst | 3 - .../deprecations/21425-AL.rst | 15 - .../deprecations/21584-AL.rst | 6 - .../deprecations/21962-AL.rst | 5 - .../deprecations/21965-AL.rst | 5 - .../deprecations/21981-AL.rst | 8 - .../deprecations/21982-AL.rst | 4 - .../deprecations/21992-AL.rst | 4 - .../deprecations/21995-AL.rst | 3 - .../deprecations/22021-AL.rst | 9 - .../deprecations/22025-AL.rst | 14 - .../deprecations/22050-AL.rst | 4 - .../deprecations/22051-AL.rst | 4 - .../deprecations/22084-SS.rst | 4 - .../deprecations/22097-AL.rst | 3 - .../deprecations/22123-TH.rst | 4 - .../deprecations/22133-OG.rst | 6 - .../deprecations/22134-OG.rst | 5 - .../deprecations/22148-OG.rst | 5 - .../deprecations/22167-EP.rst | 4 - .../deprecations/22245-AL.rst | 4 - .../deprecations/22268-OG.rst | 10 - .../deprecations/22317-AL.rst | 8 - .../deprecations/22323-GL.rst | 4 - .../deprecations/22345-JK.rst | 14 - .../deprecations/22415-AL.rst | 4 - .../deprecations/22418-AL.rst | 6 - .../deprecations/22421-AL.rst | 5 - .../deprecations/22422-AL.rst | 3 - .../deprecations/22465-AL.rst | 4 - .../deprecations/22490-AL.rst | 4 - .../deprecations/22503-AL.rst | 3 - .../deprecations/22506-AL.rst | 3 - .../deprecations/22509-AL.rst | 4 - .../deprecations/22539-AL.rst | 4 - .../deprecations/22547-AL.rst | 3 - .../deprecations/22554-AL.rst | 4 - .../deprecations/22697-OG.rst | 9 - .../deprecations/22725-AL.rst | 4 - .../deprecations/22797-OG.rst | 12 - .../deprecations/22813-GL.rst | 5 - .../deprecations/22883-AL.rst | 3 - .../deprecations/22885-AL.rst | 4 - .../deprecations/23014-OG.rst | 10 - .../deprecations/23045-OG.rst | 7 - .../deprecations/23081-OG.rst | 8 - .../deprecations/23166-ES.rst | 6 - .../deprecations/23190-OG.rst | 9 - .../deprecations/23202-GL.rst | 5 - .../deprecations/23232-TH.rst | 6 - .../deprecations/23289-AL.rst | 3 - .../deprecations/23302-TH.rst | 4 - .../deprecations/23348-AL.rst | 7 - .../deprecations/23444-AL.rst | 3 - .../deprecations/23448-AL.rst | 4 - .../deprecations/23455-OG.rst | 5 - .../deprecations/23463-OG.rst | 5 - .../deprecations/23464-AL.rst | 2 - .../deprecations/23469-AL.rst | 3 - .../deprecations/23572-AL.rst | 3 - .../deprecations/23647-OG.rst | 6 - .../deprecations/23665-GL.rst | 4 - .../deprecations/23668-TC.rst | 22 - .../deprecations/23675-OG.rst | 7 - .../deprecations/23720-RS.rst | 13 - .../deprecations/23735-ES.rst | 13 - .../deprecations/ZZZZZ-AL.rst | 4 - .../prev_api_changes/api_changes_3.6.0.rst | 2 + .../api_changes_3.6.0/deprecations.rst | 410 ++++++++++++++++++ 76 files changed, 412 insertions(+), 432 deletions(-) delete mode 100644 doc/api/next_api_changes/deprecations/16931-AL.rst delete mode 100644 doc/api/next_api_changes/deprecations/20071-AL.rst delete mode 100644 doc/api/next_api_changes/deprecations/20839-EP.rst delete mode 100644 doc/api/next_api_changes/deprecations/20995-AL.rst delete mode 100644 doc/api/next_api_changes/deprecations/21056-AL.rst delete mode 100644 doc/api/next_api_changes/deprecations/21187-AL.rst delete mode 100644 doc/api/next_api_changes/deprecations/21356-AL.rst delete mode 100644 doc/api/next_api_changes/deprecations/21412-AL.rst delete mode 100644 doc/api/next_api_changes/deprecations/21425-AL.rst delete mode 100644 doc/api/next_api_changes/deprecations/21584-AL.rst delete mode 100644 doc/api/next_api_changes/deprecations/21962-AL.rst delete mode 100644 doc/api/next_api_changes/deprecations/21965-AL.rst delete mode 100644 doc/api/next_api_changes/deprecations/21981-AL.rst delete mode 100644 doc/api/next_api_changes/deprecations/21982-AL.rst delete mode 100644 doc/api/next_api_changes/deprecations/21992-AL.rst delete mode 100644 doc/api/next_api_changes/deprecations/21995-AL.rst delete mode 100644 doc/api/next_api_changes/deprecations/22021-AL.rst delete mode 100644 doc/api/next_api_changes/deprecations/22025-AL.rst delete mode 100644 doc/api/next_api_changes/deprecations/22050-AL.rst delete mode 100644 doc/api/next_api_changes/deprecations/22051-AL.rst delete mode 100644 doc/api/next_api_changes/deprecations/22084-SS.rst delete mode 100644 doc/api/next_api_changes/deprecations/22097-AL.rst delete mode 100644 doc/api/next_api_changes/deprecations/22123-TH.rst delete mode 100644 doc/api/next_api_changes/deprecations/22133-OG.rst delete mode 100644 doc/api/next_api_changes/deprecations/22134-OG.rst delete mode 100644 doc/api/next_api_changes/deprecations/22148-OG.rst delete mode 100644 doc/api/next_api_changes/deprecations/22167-EP.rst delete mode 100644 doc/api/next_api_changes/deprecations/22245-AL.rst delete mode 100644 doc/api/next_api_changes/deprecations/22268-OG.rst delete mode 100644 doc/api/next_api_changes/deprecations/22317-AL.rst delete mode 100644 doc/api/next_api_changes/deprecations/22323-GL.rst delete mode 100644 doc/api/next_api_changes/deprecations/22345-JK.rst delete mode 100644 doc/api/next_api_changes/deprecations/22415-AL.rst delete mode 100644 doc/api/next_api_changes/deprecations/22418-AL.rst delete mode 100644 doc/api/next_api_changes/deprecations/22421-AL.rst delete mode 100644 doc/api/next_api_changes/deprecations/22422-AL.rst delete mode 100644 doc/api/next_api_changes/deprecations/22465-AL.rst delete mode 100644 doc/api/next_api_changes/deprecations/22490-AL.rst delete mode 100644 doc/api/next_api_changes/deprecations/22503-AL.rst delete mode 100644 doc/api/next_api_changes/deprecations/22506-AL.rst delete mode 100644 doc/api/next_api_changes/deprecations/22509-AL.rst delete mode 100644 doc/api/next_api_changes/deprecations/22539-AL.rst delete mode 100644 doc/api/next_api_changes/deprecations/22547-AL.rst delete mode 100644 doc/api/next_api_changes/deprecations/22554-AL.rst delete mode 100644 doc/api/next_api_changes/deprecations/22697-OG.rst delete mode 100644 doc/api/next_api_changes/deprecations/22725-AL.rst delete mode 100644 doc/api/next_api_changes/deprecations/22797-OG.rst delete mode 100644 doc/api/next_api_changes/deprecations/22813-GL.rst delete mode 100644 doc/api/next_api_changes/deprecations/22883-AL.rst delete mode 100644 doc/api/next_api_changes/deprecations/22885-AL.rst delete mode 100644 doc/api/next_api_changes/deprecations/23014-OG.rst delete mode 100644 doc/api/next_api_changes/deprecations/23045-OG.rst delete mode 100644 doc/api/next_api_changes/deprecations/23081-OG.rst delete mode 100644 doc/api/next_api_changes/deprecations/23166-ES.rst delete mode 100644 doc/api/next_api_changes/deprecations/23190-OG.rst delete mode 100644 doc/api/next_api_changes/deprecations/23202-GL.rst delete mode 100644 doc/api/next_api_changes/deprecations/23232-TH.rst delete mode 100644 doc/api/next_api_changes/deprecations/23289-AL.rst delete mode 100644 doc/api/next_api_changes/deprecations/23302-TH.rst delete mode 100644 doc/api/next_api_changes/deprecations/23348-AL.rst delete mode 100644 doc/api/next_api_changes/deprecations/23444-AL.rst delete mode 100644 doc/api/next_api_changes/deprecations/23448-AL.rst delete mode 100644 doc/api/next_api_changes/deprecations/23455-OG.rst delete mode 100644 doc/api/next_api_changes/deprecations/23463-OG.rst delete mode 100644 doc/api/next_api_changes/deprecations/23464-AL.rst delete mode 100644 doc/api/next_api_changes/deprecations/23469-AL.rst delete mode 100644 doc/api/next_api_changes/deprecations/23572-AL.rst delete mode 100644 doc/api/next_api_changes/deprecations/23647-OG.rst delete mode 100644 doc/api/next_api_changes/deprecations/23665-GL.rst delete mode 100644 doc/api/next_api_changes/deprecations/23668-TC.rst delete mode 100644 doc/api/next_api_changes/deprecations/23675-OG.rst delete mode 100644 doc/api/next_api_changes/deprecations/23720-RS.rst delete mode 100644 doc/api/next_api_changes/deprecations/23735-ES.rst delete mode 100644 doc/api/next_api_changes/deprecations/ZZZZZ-AL.rst create mode 100644 doc/api/prev_api_changes/api_changes_3.6.0/deprecations.rst diff --git a/doc/api/next_api_changes/deprecations/16931-AL.rst b/doc/api/next_api_changes/deprecations/16931-AL.rst deleted file mode 100644 index 3dfa7d2cbaf7..000000000000 --- a/doc/api/next_api_changes/deprecations/16931-AL.rst +++ /dev/null @@ -1,11 +0,0 @@ -Event handlers -~~~~~~~~~~~~~~ -The ``draw_event``, ``resize_event``, ``close_event``, ``key_press_event``, -``key_release_event``, ``pick_event``, ``scroll_event``, -``button_press_event``, ``button_release_event``, ``motion_notify_event``, -``enter_notify_event`` and ``leave_notify_event`` methods of `.FigureCanvasBase` -are deprecated. They had inconsistent signatures across backends, and made it -difficult to improve event metadata. - -In order to trigger an event on a canvas, directly construct an `.Event` object -of the correct class and call ``canvas.callbacks.process(event.name, event)``. diff --git a/doc/api/next_api_changes/deprecations/20071-AL.rst b/doc/api/next_api_changes/deprecations/20071-AL.rst deleted file mode 100644 index cf07224581ad..000000000000 --- a/doc/api/next_api_changes/deprecations/20071-AL.rst +++ /dev/null @@ -1,5 +0,0 @@ -``axes_size`` internal helpers -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -The following APIs are deprecated: ``axes_size.Padded`` (use ``size + pad`` -instead), ``axes_size.SizeFromFunc``, ``axes_size.GetExtentHelper``. diff --git a/doc/api/next_api_changes/deprecations/20839-EP.rst b/doc/api/next_api_changes/deprecations/20839-EP.rst deleted file mode 100644 index 1388abca194f..000000000000 --- a/doc/api/next_api_changes/deprecations/20839-EP.rst +++ /dev/null @@ -1,4 +0,0 @@ -Selector widget state internals -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -The *state_modifier_keys* attribute have been privatized and the modifier keys -needs to be set when creating the widget. diff --git a/doc/api/next_api_changes/deprecations/20995-AL.rst b/doc/api/next_api_changes/deprecations/20995-AL.rst deleted file mode 100644 index bdccd8f5d333..000000000000 --- a/doc/api/next_api_changes/deprecations/20995-AL.rst +++ /dev/null @@ -1,3 +0,0 @@ -``backend_gtk3.icon_filename`` and ``backend_gtk3.window_icon`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -... are deprecated with no replacement. diff --git a/doc/api/next_api_changes/deprecations/21056-AL.rst b/doc/api/next_api_changes/deprecations/21056-AL.rst deleted file mode 100644 index c97a7f2dfde6..000000000000 --- a/doc/api/next_api_changes/deprecations/21056-AL.rst +++ /dev/null @@ -1,3 +0,0 @@ -Calling ``MarkerStyle()`` with no arguments or ``MarkerStyle(None)`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -... is deprecated; use ``MarkerStyle("")`` to construct an empty marker style. diff --git a/doc/api/next_api_changes/deprecations/21187-AL.rst b/doc/api/next_api_changes/deprecations/21187-AL.rst deleted file mode 100644 index 8f4e1be05a8b..000000000000 --- a/doc/api/next_api_changes/deprecations/21187-AL.rst +++ /dev/null @@ -1,3 +0,0 @@ -``backend_gtk3.error_msg_gtk`` and ``backend_wx.error_msg_wx`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -... are deprecated. diff --git a/doc/api/next_api_changes/deprecations/21356-AL.rst b/doc/api/next_api_changes/deprecations/21356-AL.rst deleted file mode 100644 index de6cb79dd908..000000000000 --- a/doc/api/next_api_changes/deprecations/21356-AL.rst +++ /dev/null @@ -1,5 +0,0 @@ -In the future, ``dviread.find_tex_file`` will raise a ``FileNotFoundError`` for missing files -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Previously, it would return an empty string in such cases. Raising an -exception allows attaching a user-friendly message instead. During the -transition period, a warning is raised. diff --git a/doc/api/next_api_changes/deprecations/21412-AL.rst b/doc/api/next_api_changes/deprecations/21412-AL.rst deleted file mode 100644 index e101620739d9..000000000000 --- a/doc/api/next_api_changes/deprecations/21412-AL.rst +++ /dev/null @@ -1,3 +0,0 @@ -``backend_svg.generate_transform`` and ``backend_svg.generate_css`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -... are deprecated with no replacement. diff --git a/doc/api/next_api_changes/deprecations/21425-AL.rst b/doc/api/next_api_changes/deprecations/21425-AL.rst deleted file mode 100644 index d6652bfbac57..000000000000 --- a/doc/api/next_api_changes/deprecations/21425-AL.rst +++ /dev/null @@ -1,15 +0,0 @@ -3D Axis -~~~~~~~ -The previous constructor of `.axis3d.Axis`, with signature -``(self, adir, v_intervalx, d_intervalx, axes, *args, rotate_label=None, **kwargs)`` -is deprecated in favor of a new signature closer to the one of 2D Axis; it -is now ``(self, axes, *, rotate_label=None, **kwargs)`` where ``kwargs`` are -forwarded to the 2D Axis constructor. The axis direction is now inferred from -the axis class' ``axis_name`` attribute (as in the 2D case); the ``adir`` -attribute is deprecated. - -The ``init3d`` method of 3D Axis is also deprecated; all the relevant -initialization is done as part of the constructor. - -The ``d_interval`` and ``v_interval`` attributes of 3D Axis are deprecated; use -``get_data_interval`` and ``get_view_interval`` instead. diff --git a/doc/api/next_api_changes/deprecations/21584-AL.rst b/doc/api/next_api_changes/deprecations/21584-AL.rst deleted file mode 100644 index c6f47530cddb..000000000000 --- a/doc/api/next_api_changes/deprecations/21584-AL.rst +++ /dev/null @@ -1,6 +0,0 @@ -Modifications to the Groupers returned by ``get_shared_x_axes`` and ``get_shared_y_axes`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -... are deprecated. In the future, these methods will return immutable views -on the grouper structures. Note that previously, calling e.g. ``join()`` -would already fail to set up the correct structures for sharing axes; use -`.Axes.sharex` or `.Axes.sharey` instead. diff --git a/doc/api/next_api_changes/deprecations/21962-AL.rst b/doc/api/next_api_changes/deprecations/21962-AL.rst deleted file mode 100644 index e5ddab747b48..000000000000 --- a/doc/api/next_api_changes/deprecations/21962-AL.rst +++ /dev/null @@ -1,5 +0,0 @@ -``backend_pgf`` -~~~~~~~~~~~~~~~ -The following API elements have been deprecated with no -replacement: ``NO_ESCAPE``, ``re_mathsep``, ``get_fontspec``, ``get_preamble``, -``common_texification``, ``writeln``. diff --git a/doc/api/next_api_changes/deprecations/21965-AL.rst b/doc/api/next_api_changes/deprecations/21965-AL.rst deleted file mode 100644 index 6ba7bf3cc852..000000000000 --- a/doc/api/next_api_changes/deprecations/21965-AL.rst +++ /dev/null @@ -1,5 +0,0 @@ -``transOffset`` parameter name -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -The ``transOffset`` parameter of `.Collection.set_offset_transform` and the -various ``create_collection`` methods of legend handlers has been renamed to -``offset_transform`` (consistently with the property name). diff --git a/doc/api/next_api_changes/deprecations/21981-AL.rst b/doc/api/next_api_changes/deprecations/21981-AL.rst deleted file mode 100644 index 5641f09e4991..000000000000 --- a/doc/api/next_api_changes/deprecations/21981-AL.rst +++ /dev/null @@ -1,8 +0,0 @@ -``RendererGTK3Cairo`` and ``RendererGTK4Cairo`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -... have been deprecated. Use ``RendererCairo`` instead, which has gained -the ``set_context`` method, which also auto-infers the size of the underlying -surface. - -``RendererCairo.set_ctx_from_surface`` and ``RendererCairo.set_width_height`` -have likewise been deprecated, in favor of ``set_context``. diff --git a/doc/api/next_api_changes/deprecations/21982-AL.rst b/doc/api/next_api_changes/deprecations/21982-AL.rst deleted file mode 100644 index 38f37db510a7..000000000000 --- a/doc/api/next_api_changes/deprecations/21982-AL.rst +++ /dev/null @@ -1,4 +0,0 @@ -``FigureManagerGTK3Agg`` and ``FigureManagerGTK4Agg`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -... are deprecated; directly use ``FigureManagerGTK3`` and -``FigureManagerGTK4`` instead. diff --git a/doc/api/next_api_changes/deprecations/21992-AL.rst b/doc/api/next_api_changes/deprecations/21992-AL.rst deleted file mode 100644 index e3bdaba31267..000000000000 --- a/doc/api/next_api_changes/deprecations/21992-AL.rst +++ /dev/null @@ -1,4 +0,0 @@ -``lastrect`` -~~~~~~~~~~~~ -The ``lastrect`` attribute of ``NavigationToolbar2Tk`` and ``RubberbandTk`` is -deprecated. diff --git a/doc/api/next_api_changes/deprecations/21995-AL.rst b/doc/api/next_api_changes/deprecations/21995-AL.rst deleted file mode 100644 index e9b7dab027f0..000000000000 --- a/doc/api/next_api_changes/deprecations/21995-AL.rst +++ /dev/null @@ -1,3 +0,0 @@ -``ImageMagickBase.delay`` and ``ImageMagickBase.output_args`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -are deprecated with no replacement. diff --git a/doc/api/next_api_changes/deprecations/22021-AL.rst b/doc/api/next_api_changes/deprecations/22021-AL.rst deleted file mode 100644 index 24b565409b97..000000000000 --- a/doc/api/next_api_changes/deprecations/22021-AL.rst +++ /dev/null @@ -1,9 +0,0 @@ -``NavigationToolbar2GTK3`` window -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -The *window* parameter to ``NavigationToolbar2GTK3`` had no effect, and is now -deprecated; likewise, the ``win`` attribute is deprecated. - -``NavigationToolbar2Tk`` window -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -The *window* attribute to ``NavigationToolbar2GTK3`` is deprecated. Use -``toolbar.master`` instead. diff --git a/doc/api/next_api_changes/deprecations/22025-AL.rst b/doc/api/next_api_changes/deprecations/22025-AL.rst deleted file mode 100644 index 52a4fc04707a..000000000000 --- a/doc/api/next_api_changes/deprecations/22025-AL.rst +++ /dev/null @@ -1,14 +0,0 @@ -``FigureFrameWx`` attributes and methods -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -- ``sizer`` is deprecated (use ``frame.GetSizer()`` instead). -- ``figmgr`` and ``get_figure_manager`` are deprecated (use - ``frame.canvas.manager`` instead). -- ``num`` is deprecated (use ``frame.canvas.manager.num`` instead). -- ``toolbar`` is deprecated (use ``frame.GetToolBar()`` - instead). -- ``toolmanager`` is deprecated (use ``frame.canvas.manager.toolmanager`` - instead). - -``RendererWx.offset_text_height`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -... is deprecated. diff --git a/doc/api/next_api_changes/deprecations/22050-AL.rst b/doc/api/next_api_changes/deprecations/22050-AL.rst deleted file mode 100644 index df32560157c3..000000000000 --- a/doc/api/next_api_changes/deprecations/22050-AL.rst +++ /dev/null @@ -1,4 +0,0 @@ -``FigureCanvasBase.resize`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~ -This method has no effect and is deprecated. Use ``FigureManagerBase.resize`` -instead. diff --git a/doc/api/next_api_changes/deprecations/22051-AL.rst b/doc/api/next_api_changes/deprecations/22051-AL.rst deleted file mode 100644 index 468cdd39ae53..000000000000 --- a/doc/api/next_api_changes/deprecations/22051-AL.rst +++ /dev/null @@ -1,4 +0,0 @@ -``FigureCanvas`` without a ``required_interactive_framework`` attribute -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Support for such canvas classes is deprecated. Note that canvas classes which -inherit from ``FigureCanvasBase`` always have such an attribute. diff --git a/doc/api/next_api_changes/deprecations/22084-SS.rst b/doc/api/next_api_changes/deprecations/22084-SS.rst deleted file mode 100644 index ff835dce710c..000000000000 --- a/doc/api/next_api_changes/deprecations/22084-SS.rst +++ /dev/null @@ -1,4 +0,0 @@ -``Axes3D.dist`` -~~~~~~~~~~~~~~~ -... has been privatized. Use the ``zoom`` keyword argument in -`.Axes3D.set_box_aspect` instead. diff --git a/doc/api/next_api_changes/deprecations/22097-AL.rst b/doc/api/next_api_changes/deprecations/22097-AL.rst deleted file mode 100644 index 0af7e16264c8..000000000000 --- a/doc/api/next_api_changes/deprecations/22097-AL.rst +++ /dev/null @@ -1,3 +0,0 @@ -``AxisArtistHelper.delta1`` and ``AxisArtistHelper.delta2`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -... are deprecated with no replacement. diff --git a/doc/api/next_api_changes/deprecations/22123-TH.rst b/doc/api/next_api_changes/deprecations/22123-TH.rst deleted file mode 100644 index 5b65ac760bd6..000000000000 --- a/doc/api/next_api_changes/deprecations/22123-TH.rst +++ /dev/null @@ -1,4 +0,0 @@ -``Axes.get_window_extent`` and ``Figure.get_window_extent`` won't accept parameters other than *renderer* anymore -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -This aligns the API with the general `.Artist.get_window_extent` API. -All parameters were ignored anyway. diff --git a/doc/api/next_api_changes/deprecations/22133-OG.rst b/doc/api/next_api_changes/deprecations/22133-OG.rst deleted file mode 100644 index 7a551d25ce0a..000000000000 --- a/doc/api/next_api_changes/deprecations/22133-OG.rst +++ /dev/null @@ -1,6 +0,0 @@ -``AFM``, ``configfont_pattern`` and ``Type1Font`` deprecated ------------------------------------------------------------- - -The modules ``matplotlib.AFM``, ``matplotlib.configfont_pattern``, and -``matplotlib.Type1Font`` are considered internal and public access is -deprecated. diff --git a/doc/api/next_api_changes/deprecations/22134-OG.rst b/doc/api/next_api_changes/deprecations/22134-OG.rst deleted file mode 100644 index fc68b4b7b473..000000000000 --- a/doc/api/next_api_changes/deprecations/22134-OG.rst +++ /dev/null @@ -1,5 +0,0 @@ -Modules ``tight_bbox`` and ``tight_layout`` deprecated ------------------------------------------------------- - -The modules ``matplotlib.tight_bbox`` and ``matplotlib.tight_layout`` are -considered internal and public access is deprecated. diff --git a/doc/api/next_api_changes/deprecations/22148-OG.rst b/doc/api/next_api_changes/deprecations/22148-OG.rst deleted file mode 100644 index 70a59ba39042..000000000000 --- a/doc/api/next_api_changes/deprecations/22148-OG.rst +++ /dev/null @@ -1,5 +0,0 @@ -Module ``docstring`` deprecated -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -The module ``matplotlib.docstring`` is considered internal and public access -is deprecated. diff --git a/doc/api/next_api_changes/deprecations/22167-EP.rst b/doc/api/next_api_changes/deprecations/22167-EP.rst deleted file mode 100644 index 5cc1c9991e01..000000000000 --- a/doc/api/next_api_changes/deprecations/22167-EP.rst +++ /dev/null @@ -1,4 +0,0 @@ -Selector widget state internals -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -The *visible* attribute has been deprecated, use *set_visible* or -*get_visible* instead. diff --git a/doc/api/next_api_changes/deprecations/22245-AL.rst b/doc/api/next_api_changes/deprecations/22245-AL.rst deleted file mode 100644 index e49a44e69b4b..000000000000 --- a/doc/api/next_api_changes/deprecations/22245-AL.rst +++ /dev/null @@ -1,4 +0,0 @@ -*cleared* parameter of ``get_renderer`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -This parameter, which only existed for agg-based backends, has been deprecated. -Use ``renderer.clear()`` instead to explicitly clear the renderer buffer. diff --git a/doc/api/next_api_changes/deprecations/22268-OG.rst b/doc/api/next_api_changes/deprecations/22268-OG.rst deleted file mode 100644 index 79efe3783cea..000000000000 --- a/doc/api/next_api_changes/deprecations/22268-OG.rst +++ /dev/null @@ -1,10 +0,0 @@ -``ticker`` functions deprecated -------------------------------- - -The functions ``matplotlib.ticker.is_decade`` and -``matplotlib.ticker.is_close_to_int`` are considered internal and public access -is deprecated. - -For ``is_close_to_int`` use ``math.isclose(x, round(x))`` instead. -For ``is_decade`` use -``y = numpy.log(x)/numpy.log(base); numpy.isclose(y, numpy.round(y))`` diff --git a/doc/api/next_api_changes/deprecations/22317-AL.rst b/doc/api/next_api_changes/deprecations/22317-AL.rst deleted file mode 100644 index 0b6093a993ce..000000000000 --- a/doc/api/next_api_changes/deprecations/22317-AL.rst +++ /dev/null @@ -1,8 +0,0 @@ -seaborn styles renamed -~~~~~~~~~~~~~~~~~~~~~~ -Matplotlib currently ships many style files inspired from the seaborn -library ("seaborn", "seaborn-bright", "seaborn-colorblind", etc.) but they -have gone out of sync with the library itself since the release of seaborn -0.9. To prevent confusion, the style files have been renamed "seaborn-v0_8", -"seaborn-v0_8-bright", "seaborn-v0_8-colorblind", etc. Users are encouraged to -directly use seaborn to access the up-to-date styles. diff --git a/doc/api/next_api_changes/deprecations/22323-GL.rst b/doc/api/next_api_changes/deprecations/22323-GL.rst deleted file mode 100644 index b755c7804731..000000000000 --- a/doc/api/next_api_changes/deprecations/22323-GL.rst +++ /dev/null @@ -1,4 +0,0 @@ -``matplotlib.cbook.maxdict`` is deprecated -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -This class has been deprecated in favor of the standard library -``functools.lru_cache``. diff --git a/doc/api/next_api_changes/deprecations/22345-JK.rst b/doc/api/next_api_changes/deprecations/22345-JK.rst deleted file mode 100644 index 003952fd705f..000000000000 --- a/doc/api/next_api_changes/deprecations/22345-JK.rst +++ /dev/null @@ -1,14 +0,0 @@ -Pending deprecation of layout methods -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -The methods `~.Figure.set_tight_layout`, `~.Figure.set_constrained_layout`, -are discouraged, and now emit a ``PendingDeprecationWarning`` in favor of -explicitly referencing the layout engine via -``figure.set_layout_engine('tight')`` and -``figure.set_layout_engine('constrained')``. End users should not see the -warning, but library authors should adjust. - -The methods `~.Figure.set_constrained_layout_pads` and -`~.Figure.get_constrained_layout_pads` are will be deprecated in favor of -``figure.get_layout_engine().set()`` and -``figure.get_layout_engine().get()``, and currently emit a -``PendingDeprecationWarning``. diff --git a/doc/api/next_api_changes/deprecations/22415-AL.rst b/doc/api/next_api_changes/deprecations/22415-AL.rst deleted file mode 100644 index 4991834136ef..000000000000 --- a/doc/api/next_api_changes/deprecations/22415-AL.rst +++ /dev/null @@ -1,4 +0,0 @@ -*emit* and *auto* parameters of ``set_xlim``, ``set_ylim``, ``set_zlim``, ``set_rlim`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Passing these parameters positionally is deprecated; they will become -keyword-only in a future release. diff --git a/doc/api/next_api_changes/deprecations/22418-AL.rst b/doc/api/next_api_changes/deprecations/22418-AL.rst deleted file mode 100644 index 8e7fb763223b..000000000000 --- a/doc/api/next_api_changes/deprecations/22418-AL.rst +++ /dev/null @@ -1,6 +0,0 @@ -Auto-removal of overlapping Axes by ``plt.subplot`` and ``plt.subplot2grid`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Previously, `.pyplot.subplot` and `.pyplot.subplot2grid` would automatically -remove preexisting Axes that overlap with the newly added Axes. This behavior -was deemed confusing, and is now deprecated. Explicitly call ``ax.remove()`` -on Axes that need to be removed. diff --git a/doc/api/next_api_changes/deprecations/22421-AL.rst b/doc/api/next_api_changes/deprecations/22421-AL.rst deleted file mode 100644 index 36b92d233d12..000000000000 --- a/doc/api/next_api_changes/deprecations/22421-AL.rst +++ /dev/null @@ -1,5 +0,0 @@ -Parameters to ``plt.figure()`` and the ``Figure`` constructor -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -All parameters to `.pyplot.figure` and the `.Figure` constructor, other than -*num*, *figsize*, and *dpi*, will become keyword-only after a deprecation -period. diff --git a/doc/api/next_api_changes/deprecations/22422-AL.rst b/doc/api/next_api_changes/deprecations/22422-AL.rst deleted file mode 100644 index 174e4e50f1d3..000000000000 --- a/doc/api/next_api_changes/deprecations/22422-AL.rst +++ /dev/null @@ -1,3 +0,0 @@ -``backend_ps.convert_psfrags`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -... is deprecated. diff --git a/doc/api/next_api_changes/deprecations/22465-AL.rst b/doc/api/next_api_changes/deprecations/22465-AL.rst deleted file mode 100644 index 95e3319cf149..000000000000 --- a/doc/api/next_api_changes/deprecations/22465-AL.rst +++ /dev/null @@ -1,4 +0,0 @@ -``mpl_toolkits.axes_grid1.axes_size.AddList`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -... is deprecated due to being unused. Use ``sum(sizes, start=Fixed(0))`` (for -example) to sum multiple size objects. diff --git a/doc/api/next_api_changes/deprecations/22490-AL.rst b/doc/api/next_api_changes/deprecations/22490-AL.rst deleted file mode 100644 index 735a1ca350c3..000000000000 --- a/doc/api/next_api_changes/deprecations/22490-AL.rst +++ /dev/null @@ -1,4 +0,0 @@ -``Affine2D.identity()`` -~~~~~~~~~~~~~~~~~~~~~~~ -... is deprecated in favor of directly calling the `.Affine2D` constructor with -no arguments. diff --git a/doc/api/next_api_changes/deprecations/22503-AL.rst b/doc/api/next_api_changes/deprecations/22503-AL.rst deleted file mode 100644 index fb5990e5c4f0..000000000000 --- a/doc/api/next_api_changes/deprecations/22503-AL.rst +++ /dev/null @@ -1,3 +0,0 @@ -``backend_qt.qApp`` -~~~~~~~~~~~~~~~~~~~ -... is deprecated. Use ``QtWidgets.QApplication.instance()`` instead. diff --git a/doc/api/next_api_changes/deprecations/22506-AL.rst b/doc/api/next_api_changes/deprecations/22506-AL.rst deleted file mode 100644 index fe3611563c63..000000000000 --- a/doc/api/next_api_changes/deprecations/22506-AL.rst +++ /dev/null @@ -1,3 +0,0 @@ -``MathtextBackend``, ``MathtextBackendAgg``, ``MathtextBackendPath``, ``MathTextWarning`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -... are deprecated with no replacement. diff --git a/doc/api/next_api_changes/deprecations/22509-AL.rst b/doc/api/next_api_changes/deprecations/22509-AL.rst deleted file mode 100644 index 01191b500757..000000000000 --- a/doc/api/next_api_changes/deprecations/22509-AL.rst +++ /dev/null @@ -1,4 +0,0 @@ -``ToolBase.destroy`` -~~~~~~~~~~~~~~~~~~~~ -... is deprecated. To run code upon tool removal, connect to the -``tool_removed_event`` event. diff --git a/doc/api/next_api_changes/deprecations/22539-AL.rst b/doc/api/next_api_changes/deprecations/22539-AL.rst deleted file mode 100644 index 51e2d2a77de4..000000000000 --- a/doc/api/next_api_changes/deprecations/22539-AL.rst +++ /dev/null @@ -1,4 +0,0 @@ -``matplotlib.text.get_rotation()`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -... is deprecated with no replacement. Copy the original implementation if -needed. diff --git a/doc/api/next_api_changes/deprecations/22547-AL.rst b/doc/api/next_api_changes/deprecations/22547-AL.rst deleted file mode 100644 index 274d3fa3f014..000000000000 --- a/doc/api/next_api_changes/deprecations/22547-AL.rst +++ /dev/null @@ -1,3 +0,0 @@ -``TextToPath.get_texmanager`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -... is deprecated; directly construct a `.texmanager.TexManager` instead. diff --git a/doc/api/next_api_changes/deprecations/22554-AL.rst b/doc/api/next_api_changes/deprecations/22554-AL.rst deleted file mode 100644 index f7c461c2bbf0..000000000000 --- a/doc/api/next_api_changes/deprecations/22554-AL.rst +++ /dev/null @@ -1,4 +0,0 @@ -``_DummyAxis.dataLim`` and ``_DummyAxis.viewLim`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -... are deprecated. Use ``get_data_interval()``, ``set_data_interval()``, -``get_view_interval()``, and ``set_view_interval()`` instead. diff --git a/doc/api/next_api_changes/deprecations/22697-OG.rst b/doc/api/next_api_changes/deprecations/22697-OG.rst deleted file mode 100644 index d3ac3d85f0fc..000000000000 --- a/doc/api/next_api_changes/deprecations/22697-OG.rst +++ /dev/null @@ -1,9 +0,0 @@ -Deprecations in ``testing.decorators`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -The unused class ``CleanupTestCase`` and decorator ``cleanup`` are deprecated -and will be removed. Vendor the code, including the private function -``_cleanup_cm``. - -The function ``check_freetype_version`` is considered internal and deprecated. -Vendor the code of the private function ``_check_freetype_version``. diff --git a/doc/api/next_api_changes/deprecations/22725-AL.rst b/doc/api/next_api_changes/deprecations/22725-AL.rst deleted file mode 100644 index 4ca25374c2e4..000000000000 --- a/doc/api/next_api_changes/deprecations/22725-AL.rst +++ /dev/null @@ -1,4 +0,0 @@ -``TexManager.get_font_config`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -... is deprecated with no replacement. (It previously returned an internal -hashed key for used for caching purposes.) diff --git a/doc/api/next_api_changes/deprecations/22797-OG.rst b/doc/api/next_api_changes/deprecations/22797-OG.rst deleted file mode 100644 index c263a3969d4b..000000000000 --- a/doc/api/next_api_changes/deprecations/22797-OG.rst +++ /dev/null @@ -1,12 +0,0 @@ -Deprecation of helper functions in backends -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -The following functions are considered private and deprecated. Vendor the code -of the similarly named private functions if you rely on these functions. - -* ``backend_pdf.fill`` -* ``backend_ps.quote_ps_string`` -* ``backend_svg.escape_attrib`` -* ``backend_svg.escape_cdata`` -* ``backend_svg.escape_comment`` -* ``backend_svg.short_float_fmt`` diff --git a/doc/api/next_api_changes/deprecations/22813-GL.rst b/doc/api/next_api_changes/deprecations/22813-GL.rst deleted file mode 100644 index 476ee7975e17..000000000000 --- a/doc/api/next_api_changes/deprecations/22813-GL.rst +++ /dev/null @@ -1,5 +0,0 @@ -``figure.callbacks`` is deprecated -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -The figure callbacks property is deprecated. The only signal was -"dpi_changed", which can be replaced by connecting to the "resize_event" -on the canvas ``figure.canvas.mpl_connect("resize_event", func)`` instead. diff --git a/doc/api/next_api_changes/deprecations/22883-AL.rst b/doc/api/next_api_changes/deprecations/22883-AL.rst deleted file mode 100644 index 916658e6f1e2..000000000000 --- a/doc/api/next_api_changes/deprecations/22883-AL.rst +++ /dev/null @@ -1,3 +0,0 @@ -Passing too many positional arguments to ``tripcolor`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -... is now deprecated (extra arguments were previously silently ignored). diff --git a/doc/api/next_api_changes/deprecations/22885-AL.rst b/doc/api/next_api_changes/deprecations/22885-AL.rst deleted file mode 100644 index 3eb235cb7c8c..000000000000 --- a/doc/api/next_api_changes/deprecations/22885-AL.rst +++ /dev/null @@ -1,4 +0,0 @@ -``backend_pdf.Operator`` and ``backend_pdf.Op.op`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -... are deprecated in favor of a single standard `enum.Enum` interface on -`.backend_pdf.Op`. diff --git a/doc/api/next_api_changes/deprecations/23014-OG.rst b/doc/api/next_api_changes/deprecations/23014-OG.rst deleted file mode 100644 index b7d995e22802..000000000000 --- a/doc/api/next_api_changes/deprecations/23014-OG.rst +++ /dev/null @@ -1,10 +0,0 @@ -Methods to set parameters in ``LogLocator`` and ``LogFormatter*`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -In `~.LogFormatter` and derived subclasses, the methods ``base`` and -``label_minor`` for setting the respective parameter are deprecated and -replaced by ``set_base`` and ``set_label_minor``, respectively. - -In `~.LogLocator`, the methods ``base`` and ``subs`` for setting the -respective parameter are deprecated. Instead, use -``set_params(base=..., subs=...)``. diff --git a/doc/api/next_api_changes/deprecations/23045-OG.rst b/doc/api/next_api_changes/deprecations/23045-OG.rst deleted file mode 100644 index e10c410999ad..000000000000 --- a/doc/api/next_api_changes/deprecations/23045-OG.rst +++ /dev/null @@ -1,7 +0,0 @@ -``checkdep_usetex`` deprecated -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -This method was only intended to disable tests in case no latex install was -found. As such, it is considered to be private and for internal use only. - -Please vendor the code if you need this. diff --git a/doc/api/next_api_changes/deprecations/23081-OG.rst b/doc/api/next_api_changes/deprecations/23081-OG.rst deleted file mode 100644 index da7f697023c0..000000000000 --- a/doc/api/next_api_changes/deprecations/23081-OG.rst +++ /dev/null @@ -1,8 +0,0 @@ -``date_ticker_factory`` deprecated -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -The ``date_ticker_factory`` method in the `matplotlib.dates` module is -deprecated. Instead use `~.AutoDateLocator` and `~.AutoDateFormatter` for a -more flexible and scalable locator and formatter. - -If you need the exact ``date_ticker_factory`` behavior, please copy the code. diff --git a/doc/api/next_api_changes/deprecations/23166-ES.rst b/doc/api/next_api_changes/deprecations/23166-ES.rst deleted file mode 100644 index 34392973306f..000000000000 --- a/doc/api/next_api_changes/deprecations/23166-ES.rst +++ /dev/null @@ -1,6 +0,0 @@ -Positional arguments in Artist constructors -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Passing all but the very few first arguments positionally in the constructors -of Artists is deprecated. Most arguments will become keyword-only in a future -version. diff --git a/doc/api/next_api_changes/deprecations/23190-OG.rst b/doc/api/next_api_changes/deprecations/23190-OG.rst deleted file mode 100644 index 0fe0624a2382..000000000000 --- a/doc/api/next_api_changes/deprecations/23190-OG.rst +++ /dev/null @@ -1,9 +0,0 @@ -Unused methods in ``Axis``, ``Tick``, ``XAxis``, and ``YAxis`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -The following methods are no longer used and deprecated without a replacement:: - - - ``Axis.get_ticklabel_extents`` - - ``Tick.get_pad_pixels`` - - ``XAxis.get_text_heights`` - - ``YAxis.get_text_widths`` diff --git a/doc/api/next_api_changes/deprecations/23202-GL.rst b/doc/api/next_api_changes/deprecations/23202-GL.rst deleted file mode 100644 index c4e7a6538a7c..000000000000 --- a/doc/api/next_api_changes/deprecations/23202-GL.rst +++ /dev/null @@ -1,5 +0,0 @@ -``Axes.get_renderer_cache`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -The canvas now takes care of the renderer and whether to cache it -or not. The alternative is to call ``axes.figure.canvas.get_renderer()``. diff --git a/doc/api/next_api_changes/deprecations/23232-TH.rst b/doc/api/next_api_changes/deprecations/23232-TH.rst deleted file mode 100644 index c4df9f3bc666..000000000000 --- a/doc/api/next_api_changes/deprecations/23232-TH.rst +++ /dev/null @@ -1,6 +0,0 @@ -Passing *linefmt* positionally is undeprecated -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Positional use of all formatting parameters in `~.Axes.stem` has been -deprecated since Matplotlib 3.5. This deprecation is relaxed so that one can -still pass *linefmt* positionally, i.e. ``stem(x, y, 'r')``. diff --git a/doc/api/next_api_changes/deprecations/23289-AL.rst b/doc/api/next_api_changes/deprecations/23289-AL.rst deleted file mode 100644 index 85ce88e6fe1c..000000000000 --- a/doc/api/next_api_changes/deprecations/23289-AL.rst +++ /dev/null @@ -1,3 +0,0 @@ -``backend_pdf.Name.hexify`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~ -... is deprecated with no replacement. diff --git a/doc/api/next_api_changes/deprecations/23302-TH.rst b/doc/api/next_api_changes/deprecations/23302-TH.rst deleted file mode 100644 index 777c1f975590..000000000000 --- a/doc/api/next_api_changes/deprecations/23302-TH.rst +++ /dev/null @@ -1,4 +0,0 @@ -``stem(..., use_line_collection=False)`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -... is deprecated with no replacement. This was compatibility fallback to a -former more inefficient representation of the stem lines. diff --git a/doc/api/next_api_changes/deprecations/23348-AL.rst b/doc/api/next_api_changes/deprecations/23348-AL.rst deleted file mode 100644 index e4f0443f58e0..000000000000 --- a/doc/api/next_api_changes/deprecations/23348-AL.rst +++ /dev/null @@ -1,7 +0,0 @@ -The ``canvas`` and ``background`` attributes of ``MultiCursor`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -... are deprecated with no replacement. - -All parameters to ``MultiCursor`` starting from *useblit* -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -... are becoming keyword-only (passing them positionally is deprecated). diff --git a/doc/api/next_api_changes/deprecations/23444-AL.rst b/doc/api/next_api_changes/deprecations/23444-AL.rst deleted file mode 100644 index 6c4d4603ff9f..000000000000 --- a/doc/api/next_api_changes/deprecations/23444-AL.rst +++ /dev/null @@ -1,3 +0,0 @@ -The ``texcommand`` and ``latex_header`` attributes of ``backend_pgf.LatexManager`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -... are deprecated. diff --git a/doc/api/next_api_changes/deprecations/23448-AL.rst b/doc/api/next_api_changes/deprecations/23448-AL.rst deleted file mode 100644 index 11a1c6395c94..000000000000 --- a/doc/api/next_api_changes/deprecations/23448-AL.rst +++ /dev/null @@ -1,4 +0,0 @@ -``FigureCanvasBase.pick`` -~~~~~~~~~~~~~~~~~~~~~~~~~ -... is deprecated. Directly call `.Figure.pick`, which has taken over the -responsibility of checking the canvas widgetlock as well. diff --git a/doc/api/next_api_changes/deprecations/23455-OG.rst b/doc/api/next_api_changes/deprecations/23455-OG.rst deleted file mode 100644 index 826aef546a16..000000000000 --- a/doc/api/next_api_changes/deprecations/23455-OG.rst +++ /dev/null @@ -1,5 +0,0 @@ -``w_xaxis``, ``w_yaxis``, and ``w_zaxis`` of ``Axis3D`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -... have been pending deprecation since 3.1. They are now deprecated. -Instead use ``xaxis``, ``yaxis``, and ``zaxis``. diff --git a/doc/api/next_api_changes/deprecations/23463-OG.rst b/doc/api/next_api_changes/deprecations/23463-OG.rst deleted file mode 100644 index 7d8309462dbf..000000000000 --- a/doc/api/next_api_changes/deprecations/23463-OG.rst +++ /dev/null @@ -1,5 +0,0 @@ -``Tick.label`` -~~~~~~~~~~~~~~ - -... has been pending deprecation since 3.1 and is now deprecated. -Use ``Tick.label1`` instead. diff --git a/doc/api/next_api_changes/deprecations/23464-AL.rst b/doc/api/next_api_changes/deprecations/23464-AL.rst deleted file mode 100644 index 91ab83fc6fe9..000000000000 --- a/doc/api/next_api_changes/deprecations/23464-AL.rst +++ /dev/null @@ -1,2 +0,0 @@ -``FigureManagerMac.close`` is deprecated -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ diff --git a/doc/api/next_api_changes/deprecations/23469-AL.rst b/doc/api/next_api_changes/deprecations/23469-AL.rst deleted file mode 100644 index e045a9018ad6..000000000000 --- a/doc/api/next_api_changes/deprecations/23469-AL.rst +++ /dev/null @@ -1,3 +0,0 @@ -``axislines.GridHelperBase.new_gridlines`` and ``axislines.Axes.new_gridlines`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -... are deprecated. diff --git a/doc/api/next_api_changes/deprecations/23572-AL.rst b/doc/api/next_api_changes/deprecations/23572-AL.rst deleted file mode 100644 index 0569b3a73389..000000000000 --- a/doc/api/next_api_changes/deprecations/23572-AL.rst +++ /dev/null @@ -1,3 +0,0 @@ -``GridSpecBase.get_grid_positions(..., raw=True)`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -... is deprecated. diff --git a/doc/api/next_api_changes/deprecations/23647-OG.rst b/doc/api/next_api_changes/deprecations/23647-OG.rst deleted file mode 100644 index ee44f491812f..000000000000 --- a/doc/api/next_api_changes/deprecations/23647-OG.rst +++ /dev/null @@ -1,6 +0,0 @@ -``mplot3d.axis3d.Axis.set_pane_pos`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -... is deprecated. This is an internal method where the provided values are -overwritten during drawing. Hence, it does not serve any purpose to be -directly accessible. diff --git a/doc/api/next_api_changes/deprecations/23665-GL.rst b/doc/api/next_api_changes/deprecations/23665-GL.rst deleted file mode 100644 index 8cc893a7fa63..000000000000 --- a/doc/api/next_api_changes/deprecations/23665-GL.rst +++ /dev/null @@ -1,4 +0,0 @@ -The macosx backend toolbar ``prepare_configure_subplots`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - - has been replaced by ``configure_subplots()``. diff --git a/doc/api/next_api_changes/deprecations/23668-TC.rst b/doc/api/next_api_changes/deprecations/23668-TC.rst deleted file mode 100644 index d131ff497fb1..000000000000 --- a/doc/api/next_api_changes/deprecations/23668-TC.rst +++ /dev/null @@ -1,22 +0,0 @@ -Pending deprecation top-level cmap registration and access functions in ``mpl.cm`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -As part of a `multi-step process -`_ we are refactoring -the global state for managing the registered colormaps. - -In Matplotlib 3.5 we added a `.ColormapRegistry` class and exposed an -instance at the top level as ``matplotlib.colormaps``. The existing -top level functions in `matplotlib.cm` (``get_cmap``, ``register_cmap``, -``unregister_cmap``) were changed to be aliases around the same instance. - -In Matplotlib 3.6 we have marked those top level functions as pending -deprecation with the intention of deprecation in Matplotlib 3.7. The -following functions have been marked for pending deprecation: - -- `matplotlib.cm.get_cmap` - use ``matplotlib.colormaps[name]`` instead -- `matplotlib.cm.register_cmap` - use ``matplotlib.colormaps.register`` instead -- `matplotlib.cm.unregister_cmap` - use ``matplotlib.colormaps.unregister`` instead -- ``matplotlib.pyplot.register_cmap`` - use ``matplotlib.colormaps.register`` instead - -The `matplotlib.pyplot.get_cmap` function will stay available for backward compatibility. diff --git a/doc/api/next_api_changes/deprecations/23675-OG.rst b/doc/api/next_api_changes/deprecations/23675-OG.rst deleted file mode 100644 index 1ab669c16b2a..000000000000 --- a/doc/api/next_api_changes/deprecations/23675-OG.rst +++ /dev/null @@ -1,7 +0,0 @@ -Helper functions in ``mplot3d.axis3d`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -The two helper functions ``move_from_center`` and ``tick_update_position`` are -considered internal and deprecated. If these are required, please vendor the -code from the corresponding private methods ``_move_from_center`` and -``_tick_update_position``. diff --git a/doc/api/next_api_changes/deprecations/23720-RS.rst b/doc/api/next_api_changes/deprecations/23720-RS.rst deleted file mode 100644 index 9e771009aa15..000000000000 --- a/doc/api/next_api_changes/deprecations/23720-RS.rst +++ /dev/null @@ -1,13 +0,0 @@ -Deprecation aliases in cbook -~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -The module ``matplotlib.cbook.deprecation`` was previously deprecated in -Matplotlib 3.4, along with deprecation-related API in ``matplotlib.cbook``. Due -to technical issues, ``matplotlib.cbook.MatplotlibDeprecationWarning`` and -``matplotlib.cbook.mplDeprecation`` did not raise deprecation warnings on use. -Changes in Python have now made it possible to warn when these aliases are -being used. - -In order to avoid downstream breakage, these aliases will now warn, and their -removal has been pushed from 3.6 to 3.8 to give time to notice said warnings. -As replacement, please use `matplotlib.MatplotlibDeprecationWarning`. diff --git a/doc/api/next_api_changes/deprecations/23735-ES.rst b/doc/api/next_api_changes/deprecations/23735-ES.rst deleted file mode 100644 index 075abf73d9d4..000000000000 --- a/doc/api/next_api_changes/deprecations/23735-ES.rst +++ /dev/null @@ -1,13 +0,0 @@ -``AXes`` subclasses should override ``clear`` instead of ``cla`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -For clarity, `.axes.Axes.clear` is now preferred over `.Axes.cla`. However, for -backwards compatibility, the latter will remain as an alias for the former. - -For additional compatibility with third-party libraries, Matplotlib will -continue to call the ``cla`` method of any `~.axes.Axes` subclasses if they -define it. In the future, this will no longer occur, and Matplotlib will only -call the ``clear`` method in `~.axes.Axes` subclasses. - -It is recommended to define only the ``clear`` method when on Matplotlib 3.6, -and only ``cla`` for older versions. diff --git a/doc/api/next_api_changes/deprecations/ZZZZZ-AL.rst b/doc/api/next_api_changes/deprecations/ZZZZZ-AL.rst deleted file mode 100644 index 845a7c063c77..000000000000 --- a/doc/api/next_api_changes/deprecations/ZZZZZ-AL.rst +++ /dev/null @@ -1,4 +0,0 @@ -``mlab.stride_windows`` -~~~~~~~~~~~~~~~~~~~~~~~ -... is deprecated. Use ``np.lib.stride_tricks.sliding_window_view`` instead -(or ``np.lib.stride_tricks.as_strided`` on numpy<1.20). diff --git a/doc/api/prev_api_changes/api_changes_3.6.0.rst b/doc/api/prev_api_changes/api_changes_3.6.0.rst index 5f2a7648a955..1bba4506fd7d 100644 --- a/doc/api/prev_api_changes/api_changes_3.6.0.rst +++ b/doc/api/prev_api_changes/api_changes_3.6.0.rst @@ -7,6 +7,8 @@ API Changes for 3.6.0 .. include:: /api/prev_api_changes/api_changes_3.6.0/behaviour.rst +.. include:: /api/prev_api_changes/api_changes_3.6.0/deprecations.rst + .. include:: /api/prev_api_changes/api_changes_3.6.0/removals.rst .. include:: /api/prev_api_changes/api_changes_3.6.0/development.rst diff --git a/doc/api/prev_api_changes/api_changes_3.6.0/deprecations.rst b/doc/api/prev_api_changes/api_changes_3.6.0/deprecations.rst new file mode 100644 index 000000000000..99bf938dc66c --- /dev/null +++ b/doc/api/prev_api_changes/api_changes_3.6.0/deprecations.rst @@ -0,0 +1,410 @@ +Deprecations +------------ + +Parameters to ``plt.figure()`` and the ``Figure`` constructor +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +All parameters to `.pyplot.figure` and the `.Figure` constructor, other than +*num*, *figsize*, and *dpi*, will become keyword-only after a deprecation +period. + +Deprecation aliases in cbook +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The module ``matplotlib.cbook.deprecation`` was previously deprecated in +Matplotlib 3.4, along with deprecation-related API in ``matplotlib.cbook``. Due +to technical issues, ``matplotlib.cbook.MatplotlibDeprecationWarning`` and +``matplotlib.cbook.mplDeprecation`` did not raise deprecation warnings on use. +Changes in Python have now made it possible to warn when these aliases are +being used. + +In order to avoid downstream breakage, these aliases will now warn, and their +removal has been pushed from 3.6 to 3.8 to give time to notice said warnings. +As replacement, please use `matplotlib.MatplotlibDeprecationWarning`. + +``Axes`` subclasses should override ``clear`` instead of ``cla`` +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +For clarity, `.axes.Axes.clear` is now preferred over `.Axes.cla`. However, for +backwards compatibility, the latter will remain as an alias for the former. + +For additional compatibility with third-party libraries, Matplotlib will +continue to call the ``cla`` method of any `~.axes.Axes` subclasses if they +define it. In the future, this will no longer occur, and Matplotlib will only +call the ``clear`` method in `~.axes.Axes` subclasses. + +It is recommended to define only the ``clear`` method when on Matplotlib 3.6, +and only ``cla`` for older versions. + +Pending deprecation top-level cmap registration and access functions in ``mpl.cm`` +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +As part of a `multi-step process +`_ we are refactoring +the global state for managing the registered colormaps. + +In Matplotlib 3.5 we added a `.ColormapRegistry` class and exposed an instance +at the top level as ``matplotlib.colormaps``. The existing top level functions +in `matplotlib.cm` (``get_cmap``, ``register_cmap``, ``unregister_cmap``) were +changed to be aliases around the same instance. + +In Matplotlib 3.6 we have marked those top level functions as pending +deprecation with the intention of deprecation in Matplotlib 3.7. The following +functions have been marked for pending deprecation: + +- ``matplotlib.cm.get_cmap``; use ``matplotlib.colormaps[name]`` instead +- ``matplotlib.cm.register_cmap``; use `matplotlib.colormaps.register + <.ColormapRegistry.register>` instead +- ``matplotlib.cm.unregister_cmap``; use `matplotlib.colormaps.unregister + <.ColormapRegistry.unregister>` instead +- ``matplotlib.pyplot.register_cmap``; use `matplotlib.colormaps.register + <.ColormapRegistry.register>` instead + +The `matplotlib.pyplot.get_cmap` function will stay available for backward +compatibility. + +Pending deprecation of layout methods +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The methods `~.Figure.set_tight_layout`, `~.Figure.set_constrained_layout`, are +discouraged, and now emit a ``PendingDeprecationWarning`` in favor of +explicitly referencing the layout engine via +``figure.set_layout_engine('tight')`` and +``figure.set_layout_engine('constrained')``. End users should not see the +warning, but library authors should adjust. + +The methods `~.Figure.set_constrained_layout_pads` and +`~.Figure.get_constrained_layout_pads` are will be deprecated in favor of +``figure.get_layout_engine().set()`` and ``figure.get_layout_engine().get()``, +and currently emit a ``PendingDeprecationWarning``. + +seaborn styles renamed +~~~~~~~~~~~~~~~~~~~~~~ + +Matplotlib currently ships many style files inspired from the seaborn library +("seaborn", "seaborn-bright", "seaborn-colorblind", etc.) but they have gone +out of sync with the library itself since the release of seaborn 0.9. To +prevent confusion, the style files have been renamed "seaborn-v0_8", +"seaborn-v0_8-bright", "seaborn-v0_8-colorblind", etc. Users are encouraged to +directly use seaborn to access the up-to-date styles. + +Auto-removal of overlapping Axes by ``plt.subplot`` and ``plt.subplot2grid`` +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Previously, `.pyplot.subplot` and `.pyplot.subplot2grid` would automatically +remove preexisting Axes that overlap with the newly added Axes. This behavior +was deemed confusing, and is now deprecated. Explicitly call ``ax.remove()`` on +Axes that need to be removed. + +Passing *linefmt* positionally to ``stem`` is undeprecated +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Positional use of all formatting parameters in `~.Axes.stem` has been +deprecated since Matplotlib 3.5. This deprecation is relaxed so that one can +still pass *linefmt* positionally, i.e. ``stem(x, y, 'r')``. + +``stem(..., use_line_collection=False)`` +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +... is deprecated with no replacement. This was a compatibility fallback to a +former more inefficient representation of the stem lines. + +Positional / keyword arguments +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Passing all but the very few first arguments positionally in the constructors +of Artists is deprecated. Most arguments will become keyword-only in a future +version. + +Passing too many positional arguments to ``tripcolor`` is now deprecated (extra +arguments were previously silently ignored). + +Passing *emit* and *auto* parameters of ``set_xlim``, ``set_ylim``, +``set_zlim``, ``set_rlim`` positionally is deprecated; they will become +keyword-only in a future release. + +The *transOffset* parameter of `.Collection.set_offset_transform` and the +various ``create_collection`` methods of legend handlers has been renamed to +*offset_transform* (consistently with the property name). + +Calling ``MarkerStyle()`` with no arguments or ``MarkerStyle(None)`` is +deprecated; use ``MarkerStyle("")`` to construct an empty marker style. + +``Axes.get_window_extent`` / ``Figure.get_window_extent`` accept only +*renderer*. This aligns the API with the general `.Artist.get_window_extent` +API. All other parameters were ignored anyway. + +This *cleared* parameter of ``get_renderer``, which only existed for AGG-based +backends, has been deprecated. Use ``renderer.clear()`` instead to explicitly +clear the renderer buffer. + +Methods to set parameters in ``LogLocator`` and ``LogFormatter*`` +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +In `~.LogFormatter` and derived subclasses, the methods ``base`` and +``label_minor`` for setting the respective parameter are deprecated and +replaced by ``set_base`` and ``set_label_minor``, respectively. + +In `~.LogLocator`, the methods ``base`` and ``subs`` for setting the respective +parameter are deprecated. Instead, use ``set_params(base=..., subs=...)``. + +``Axes.get_renderer_cache`` +~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The canvas now takes care of the renderer and whether to cache it or not. The +alternative is to call ``axes.figure.canvas.get_renderer()``. + +Groupers from ``get_shared_x_axes`` / ``get_shared_y_axes`` will be immutable +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Modifications to the Groupers returned by ``get_shared_x_axes`` and +``get_shared_y_axes`` are deprecated. In the future, these methods will return +immutable views on the grouper structures. Note that previously, calling e.g. +``join()`` would already fail to set up the correct structures for sharing +axes; use `.Axes.sharex` or `.Axes.sharey` instead. + +Unused methods in ``Axis``, ``Tick``, ``XAxis``, and ``YAxis`` +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +``Tick.label`` has been pending deprecation since 3.1 and is now deprecated. +Use ``Tick.label1`` instead. + +The following methods are no longer used and deprecated without a replacement: + +- ``Axis.get_ticklabel_extents`` +- ``Tick.get_pad_pixels`` +- ``XAxis.get_text_heights`` +- ``YAxis.get_text_widths`` + +``mlab.stride_windows`` +~~~~~~~~~~~~~~~~~~~~~~~ + +... is deprecated. Use ``np.lib.stride_tricks.sliding_window_view`` instead (or +``np.lib.stride_tricks.as_strided`` on NumPy < 1.20). + +Event handlers +~~~~~~~~~~~~~~ + +The ``draw_event``, ``resize_event``, ``close_event``, ``key_press_event``, +``key_release_event``, ``pick_event``, ``scroll_event``, +``button_press_event``, ``button_release_event``, ``motion_notify_event``, +``enter_notify_event`` and ``leave_notify_event`` methods of +`.FigureCanvasBase` are deprecated. They had inconsistent signatures across +backends, and made it difficult to improve event metadata. + +In order to trigger an event on a canvas, directly construct an `.Event` object +of the correct class and call ``canvas.callbacks.process(event.name, event)``. + +Widgets +~~~~~~~ + +All parameters to ``MultiCursor`` starting from *useblit* are becoming +keyword-only (passing them positionally is deprecated). + +The ``canvas`` and ``background`` attributes of ``MultiCursor`` are deprecated +with no replacement. + +The *visible* attribute of Selector widgets has been deprecated; use +``set_visible`` or ``get_visible`` instead. + +The *state_modifier_keys* attribute of Selector widgets has been privatized and +the modifier keys must be set when creating the widget. + +``Axes3D.dist`` +~~~~~~~~~~~~~~~ + +... has been privatized. Use the *zoom* keyword argument in +`.Axes3D.set_box_aspect` instead. + +3D Axis +~~~~~~~ + +The previous constructor of `.axis3d.Axis`, with signature ``(self, adir, +v_intervalx, d_intervalx, axes, *args, rotate_label=None, **kwargs)`` is +deprecated in favor of a new signature closer to the one of 2D Axis; it is now +``(self, axes, *, rotate_label=None, **kwargs)`` where ``kwargs`` are forwarded +to the 2D Axis constructor. The axis direction is now inferred from the axis +class' ``axis_name`` attribute (as in the 2D case); the ``adir`` attribute is +deprecated. + +The ``init3d`` method of 3D Axis is also deprecated; all the relevant +initialization is done as part of the constructor. + +The ``d_interval`` and ``v_interval`` attributes of 3D Axis are deprecated; use +``get_data_interval`` and ``get_view_interval`` instead. + +The ``w_xaxis``, ``w_yaxis``, and ``w_zaxis`` attributes of ``Axis3D`` have +been pending deprecation since 3.1. They are now deprecated. Instead use +``xaxis``, ``yaxis``, and ``zaxis``. + +``mplot3d.axis3d.Axis.set_pane_pos`` is deprecated. This is an internal method +where the provided values are overwritten during drawing. Hence, it does not +serve any purpose to be directly accessible. + +The two helper functions ``mplot3d.axis3d.move_from_center`` and +``mplot3d.axis3d.tick_update_position`` are considered internal and deprecated. +If these are required, please vendor the code from the corresponding private +methods ``_move_from_center`` and ``_tick_update_position``. + +``Figure.callbacks`` is deprecated +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The Figure ``callbacks`` property is deprecated. The only signal was +"dpi_changed", which can be replaced by connecting to the "resize_event" on the +canvas ``figure.canvas.mpl_connect("resize_event", func)`` instead. + +``FigureCanvas`` without a ``required_interactive_framework`` attribute +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Support for such canvas classes is deprecated. Note that canvas classes which +inherit from ``FigureCanvasBase`` always have such an attribute. + +Backend-specific deprecations +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +- ``backend_gtk3.FigureManagerGTK3Agg`` and + ``backend_gtk4.FigureManagerGTK4Agg``; directly use + ``backend_gtk3.FigureManagerGTK3`` and ``backend_gtk4.FigureManagerGTK4`` + instead. +- The *window* parameter to ``backend_gtk3.NavigationToolbar2GTK3`` had no + effect, and is now deprecated. +- ``backend_gtk3.NavigationToolbar2GTK3.win`` +- ``backend_gtk3.RendererGTK3Cairo`` and ``backend_gtk4.RendererGTK4Cairo``; + use `.RendererCairo` instead, which has gained the ``set_context`` method, + which also auto-infers the size of the underlying surface. +- ``backend_cairo.RendererCairo.set_ctx_from_surface`` and + ``backend_cairo.RendererCairo.set_width_height`` in favor of + `.RendererCairo.set_context`. +- ``backend_gtk3.error_msg_gtk`` +- ``backend_gtk3.icon_filename`` and ``backend_gtk3.window_icon`` +- ``backend_macosx.NavigationToolbar2Mac.prepare_configure_subplots`` has been + replaced by ``configure_subplots()``. +- ``backend_pdf.Name.hexify`` +- ``backend_pdf.Operator`` and ``backend_pdf.Op.op`` are deprecated in favor of + a single standard `enum.Enum` interface on `.backend_pdf.Op`. +- ``backend_pdf.fill``; vendor the code of the similarly named private + functions if you rely on these functions. +- ``backend_pgf.LatexManager.texcommand`` and + ``backend_pgf.LatexManager.latex_header`` +- ``backend_pgf.NO_ESCAPE`` +- ``backend_pgf.common_texification`` +- ``backend_pgf.get_fontspec`` +- ``backend_pgf.get_preamble`` +- ``backend_pgf.re_mathsep`` +- ``backend_pgf.writeln`` +- ``backend_ps.convert_psfrags`` +- ``backend_ps.quote_ps_string``; vendor the code of the similarly named + private functions if you rely on it. +- ``backend_qt.qApp``; use ``QtWidgets.QApplication.instance()`` instead. +- ``backend_svg.escape_attrib``; vendor the code of the similarly named private + functions if you rely on it. +- ``backend_svg.escape_cdata``; vendor the code of the similarly named private + functions if you rely on it. +- ``backend_svg.escape_comment``; vendor the code of the similarly named + private functions if you rely on it. +- ``backend_svg.short_float_fmt``; vendor the code of the similarly named + private functions if you rely on it. +- ``backend_svg.generate_transform`` and ``backend_svg.generate_css`` +- ``backend_tk.NavigationToolbar2Tk.lastrect`` and + ``backend_tk.RubberbandTk.lastrect`` +- ``backend_tk.NavigationToolbar2Tk.window``; use ``toolbar.master`` instead. +- ``backend_tools.ToolBase.destroy``; To run code upon tool removal, connect to + the ``tool_removed_event`` event. +- ``backend_wx.RendererWx.offset_text_height`` +- ``backend_wx.error_msg_wx`` + +- ``FigureCanvasBase.pick``; directly call `.Figure.pick`, which has taken over + the responsibility of checking the canvas widget lock as well. +- ``FigureCanvasBase.resize``, which has no effect; use + ``FigureManagerBase.resize`` instead. + +- ``FigureManagerMac.close`` + +- ``FigureFrameWx.sizer``; use ``frame.GetSizer()`` instead. +- ``FigureFrameWx.figmgr`` and ``FigureFrameWx.get_figure_manager``; use + ``frame.canvas.manager`` instead. +- ``FigureFrameWx.num``; use ``frame.canvas.manager.num`` instead. +- ``FigureFrameWx.toolbar``; use ``frame.GetToolBar()`` instead. +- ``FigureFrameWx.toolmanager``; use ``frame.canvas.manager.toolmanager`` + instead. + +Modules +~~~~~~~ + +The modules ``matplotlib.afm``, ``matplotlib.docstring``, +``matplotlib.fontconfig_pattern``, ``matplotlib.tight_bbox``, +``matplotlib.tight_layout``, and ``matplotlib.type1font`` are considered +internal and public access is deprecated. + +``checkdep_usetex`` deprecated +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +This method was only intended to disable tests in case no latex install was +found. As such, it is considered to be private and for internal use only. + +Please vendor the code if you need this. + +``date_ticker_factory`` deprecated +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The ``date_ticker_factory`` method in the `matplotlib.dates` module is +deprecated. Instead use `~.AutoDateLocator` and `~.AutoDateFormatter` for a +more flexible and scalable locator and formatter. + +If you need the exact ``date_ticker_factory`` behavior, please copy the code. + +``dviread.find_tex_file`` will raise ``FileNotFoundError`` +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +In the future, ``dviread.find_tex_file`` will raise a ``FileNotFoundError`` for +missing files. Previously, it would return an empty string in such cases. +Raising an exception allows attaching a user-friendly message instead. During +the transition period, a warning is raised. + +``transforms.Affine2D.identity()`` +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +... is deprecated in favor of directly calling the `.Affine2D` constructor with +no arguments. + +Deprecations in ``testing.decorators`` +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The unused class ``CleanupTestCase`` and decorator ``cleanup`` are deprecated +and will be removed. Vendor the code, including the private function +``_cleanup_cm``. + +The function ``check_freetype_version`` is considered internal and deprecated. +Vendor the code of the private function ``_check_freetype_version``. + +``text.get_rotation()`` +~~~~~~~~~~~~~~~~~~~~~~~ + +... is deprecated with no replacement. Copy the original implementation if +needed. + +Miscellaneous internals +~~~~~~~~~~~~~~~~~~~~~~~ + +- ``axes_grid1.axes_size.AddList``; use ``sum(sizes, start=Fixed(0))`` (for + example) to sum multiple size objects. +- ``axes_size.Padded``; use ``size + pad`` instead +- ``axes_size.SizeFromFunc``, ``axes_size.GetExtentHelper`` +- ``AxisArtistHelper.delta1`` and ``AxisArtistHelper.delta2`` +- ``axislines.GridHelperBase.new_gridlines`` and + ``axislines.Axes.new_gridlines`` +- ``cbook.maxdict``; use the standard library ``functools.lru_cache`` instead. +- ``_DummyAxis.dataLim`` and ``_DummyAxis.viewLim``; use + ``get_data_interval()``, ``set_data_interval()``, ``get_view_interval()``, + and ``set_view_interval()`` instead. +- ``GridSpecBase.get_grid_positions(..., raw=True)`` +- ``ImageMagickBase.delay`` and ``ImageMagickBase.output_args`` +- ``MathtextBackend``, ``MathtextBackendAgg``, ``MathtextBackendPath``, + ``MathTextWarning`` +- ``TexManager.get_font_config``; it previously returned an internal hashed key + for used for caching purposes. +- ``TextToPath.get_texmanager``; directly construct a `.texmanager.TexManager` + instead. +- ``ticker.is_close_to_int``; use ``math.isclose(x, round(x))`` instead. +- ``ticker.is_decade``; use ``y = numpy.log(x)/numpy.log(base); + numpy.isclose(y, numpy.round(y))`` instead.