# Deprecations

## `figure.add_axes()` without arguments

Calling `fig.add_axes()` with no arguments currently does nothing. This
call will raise an error in the future. Adding a free-floating axes
needs a position rectangle. If you want a figure-filling single axes,
use `add_subplot()` instead.

## `backend_wx.DEBUG_MSG`

`backend_wx.DEBUG_MSG` is deprecated. The wx backends now use regular
logging.

## `Colorbar.config_axis()`

`Colorbar.config_axis()` is considered internal. Its use is deprecated.

## `NonUniformImage.is_grayscale` and `PcolorImage.is_grayscale`

These attributes are deprecated, for consistency with
`AxesImage.is_grayscale`, which was removed back in Matplotlib 2.0.0.
(Note that previously, these attributes were only available *after
rendering the image*).

## `den` parameter and attribute to `mpl_toolkits.axisartist.angle_helper`{.interpreted-text role="mod"}

For all locator classes defined in
`mpl_toolkits.axisartist.angle_helper`{.interpreted-text role="mod"},
the `den` parameter has been renamed to `nbins`, and the `den` attribute
deprecated in favor of its (preexisting) synonym `nbins`, for
consistency with locator classes defined in
`matplotlib.ticker`{.interpreted-text role="mod"}.

## `backend_pgf.LatexManager.latex_stdin_utf8`

`backend_pgf.LatexManager.latex` is now created with `encoding="utf-8"`,
so its `stdin` attribute is already utf8-encoded; the `latex_stdin_utf8`
attribute is thus deprecated.

## Flags containing \"U\" passed to [.cbook.to_filehandle]{.title-ref} and [.cbook.open_file_cm]{.title-ref}

Please remove \"U\" from flags passed to
[.cbook.to_filehandle]{.title-ref} and
[.cbook.open_file_cm]{.title-ref}. This is consistent with their removal
from [open]{.title-ref} in Python 3.9.

## PDF and PS character tracking internals

The `used_characters` attribute and `track_characters` and
`merge_used_characters` methods of [.RendererPdf]{.title-ref},
[.PdfFile]{.title-ref}, and [.RendererPS]{.title-ref} are deprecated.

## Case-insensitive capstyles and joinstyles

Please pass capstyles (\"miter\", \"round\", \"bevel\") and joinstyles
(\"butt\", \"round\", \"projecting\") as lowercase.

## Passing raw data to `register_cmap()`

Passing raw data via parameters *data* and *lut* to
`matplotlib.cm.register_cmap()` is deprecated. Instead, explicitly
create a [.LinearSegmentedColormap]{.title-ref} and pass it via the
*cmap* parameter:
`register_cmap(cmap=LinearSegmentedColormap(name, data, lut))`.

## `DateFormatter.illegal_s`

This attribute is unused and deprecated.

## `widgets.TextBox.params_to_disable`

This attribute is deprecated.

## Revert deprecation \*min, \*max keyword arguments to `set_x/y/zlim_3d()`

These keyword arguments were deprecated in 3.0, alongside with the
respective parameters in `set_xlim()` / `set_ylim()`. The deprecations
of the 2D versions were already reverted in 3.1.

## `cbook.local_over_kwdict`

This function is deprecated. Use [.cbook.normalize_kwargs]{.title-ref}
instead.

## Passing both singular and plural *colors*, *linewidths*, *linestyles* to [.Axes.eventplot]{.title-ref}

Passing e.g. both *linewidth* and *linewidths* will raise a TypeError in
the future.

## Setting `text.latex.preamble` or `pdf.preamble` rcParams to non-strings

These rcParams should be set to string values. Support for None (meaning
the empty string) and lists of strings (implicitly joined with newlines)
is deprecated.

## Parameters *norm* and *vmin*/*vmax* should not be used simultaneously

Passing parameters *norm* and *vmin*/*vmax* simultaneously to functions
using colormapping such as `scatter()` and `imshow()` is deprecated.
Instead of `norm=LogNorm(), vmin=min_val, vmax=max_val` pass
`norm=LogNorm(min_val, max_val)`. *vmin* and *vmax* should only be used
without setting *norm*.

## Effectless parameters of [.Figure.colorbar]{.title-ref} and [matplotlib.colorbar.Colorbar]{.title-ref}

The *cmap* and *norm* parameters of [.Figure.colorbar]{.title-ref} and
[matplotlib.colorbar.Colorbar]{.title-ref} have no effect because they
are always overridden by the mappable\'s colormap and norm; they are
thus deprecated. Likewise, passing the *alpha*, *boundaries*, *values*,
*extend*, or *filled* parameters with a [.ContourSet]{.title-ref}
mappable, or the *alpha* parameter with an [.Artist]{.title-ref}
mappable, is deprecated, as the mappable would likewise override them.

## `args_key` and `exec_key` attributes of builtin [.MovieWriter]{.title-ref}s

These attributes are deprecated.

## Unused parameters

The following parameters do not have any effect and are deprecated:

-   arbitrary keyword arguments to `StreamplotSet`
-   parameter *quantize* of [.Path.cleaned()]{.title-ref}
-   parameter *s* of [.AnnotationBbox.get_fontsize()]{.title-ref}
-   parameter *label* of [.Tick]{.title-ref}

## Passing *props* to [.Shadow]{.title-ref}

The parameter *props* of [.Shadow]{.title-ref} is deprecated. Use
keyword arguments instead.

## `Axes.update_datalim_bounds`

This method is deprecated. Use
`ax.dataLim.set(Bbox.union([ax.dataLim, bounds]))` instead.

## `{,Symmetrical}LogScale.{,Inverted}LogTransform`

`LogScale.LogTransform`, `LogScale.InvertedLogTransform`,
`SymmetricalScale.SymmetricalTransform` and
`SymmetricalScale.InvertedSymmetricalTransform` are deprecated. Directly
access the transform classes from the `.scale`{.interpreted-text
role="mod"} module.

## `TexManager.cachedir`, `TexManager.rgba_arrayd`

Use [matplotlib.get_cachedir()]{.title-ref} instead for the former;
there is no replacement for the latter.

## Setting [.Line2D]{.title-ref}\'s pickradius via [.Line2D.set_picker]{.title-ref}

Setting a [.Line2D]{.title-ref}\'s pickradius (i.e. the tolerance for
pick events and containment checks) via [.Line2D.set_picker]{.title-ref}
is deprecated. Use [.Line2D.set_pickradius]{.title-ref} instead.

[.Line2D.set_picker]{.title-ref} no longer sets the artist\'s
custom-contain() check.

## `Artist.set_contains`, `Artist.get_contains`

Setting a custom method overriding [.Artist.contains]{.title-ref} is
deprecated. There is no replacement, but you may still customize pick
events using [.Artist.set_picker]{.title-ref}.

## [\~matplotlib.colorbar.Colorbar]{.title-ref} methods

The `on_mappable_changed` and `update_bruteforce` methods of
[\~matplotlib.colorbar.Colorbar]{.title-ref} are deprecated; both can be
replaced by calls to
[\~matplotlib.colorbar.Colorbar.update_normal]{.title-ref}.

## `OldScalarFormatter`, `IndexFormatter` and `IndexDateFormatter`

These formatters are deprecated. Their functionality can be implemented
using e.g. [.FuncFormatter]{.title-ref}.

## `OldAutoLocator`

This ticker is deprecated.

## *required*, *forbidden* and *allowed* parameters of [.cbook.normalize_kwargs]{.title-ref}

These parameters are deprecated.

## The `TTFPATH` and `AFMPATH` environment variables

Support for the (undocumented) `TTFPATH` and `AFMPATH` environment
variables is deprecated. Additional fonts may be registered using
`matplotlib.font_manager.fontManager.addfont()`.

## `matplotlib.compat`

This module is deprecated.

## `matplotlib.backends.qt_editor.formsubplottool`

This module is deprecated. Use
`matplotlib.backends.backend_qt5.SubplotToolQt` instead.

## AVConv animation writer deprecated

The `AVConvBase`, `AVConvWriter` and `AVConvFileWriter` classes, and the
associated `animation.avconv_path` and `animation.avconv_args` rcParams
are deprecated.

Debian 8 (2015, EOL 06/2020) and Ubuntu 14.04 (EOL 04/2019) were the
last versions of Debian and Ubuntu to ship avconv. It remains possible
to force the use of avconv by using the ffmpeg-based writers with
`animation.ffmpeg_path`{.interpreted-text role="rc"} set to \"avconv\".

## log/symlog scale base, ticks, and nonpos specification

[\~.Axes.semilogx]{.title-ref}, [\~.Axes.semilogy]{.title-ref},
[\~.Axes.loglog]{.title-ref}, [.LogScale]{.title-ref}, and
[.SymmetricalLogScale]{.title-ref} used to take keyword arguments that
depends on the axis orientation (\"basex\" vs \"basey\", \"subsx\" vs
\"subsy\", \"nonposx\" vs \"nonposy\"); these parameter names are now
deprecated in favor of \"base\", \"subs\", \"nonpositive\". This
deprecation also affects e.g. `ax.set_yscale("log", basey=...)` which
must now be spelled `ax.set_yscale("log", base=...)`.

The change from \"nonpos\" to \"nonpositive\" also affects
[\~.scale.LogTransform]{.title-ref},
[\~.scale.InvertedLogTransform]{.title-ref},
[\~.scale.SymmetricalLogTransform]{.title-ref}, etc.

To use *different* bases for the x-axis and y-axis of a
[\~.Axes.loglog]{.title-ref} plot, use e.g.
`ax.set_xscale("log", base=10); ax.set_yscale("log", base=2)`.

## `DraggableBase.artist_picker`

This method is deprecated. If you previously reimplemented it in a
subclass, set the artist\'s picker instead with
[.Artist.set_picker]{.title-ref}.

## *clear_temp* parameter and attribute of [.FileMovieWriter]{.title-ref}

The *clear_temp* parameter and attribute of
[.FileMovieWriter]{.title-ref} is deprecated. In the future, files
placed in a temporary directory (using `frame_prefix=None`, the default)
will be cleared; files placed elsewhere will not.

## Deprecated rcParams validators

The following validators, defined in [.rcsetup]{.title-ref}, are
deprecated: `validate_fontset`, `validate_mathtext_default`,
`validate_alignment`, `validate_svg_fonttype`, `validate_pgf_texsystem`,
`validate_movie_frame_fmt`, `validate_axis_locator`,
`validate_movie_html_fmt`, `validate_grid_axis`,
`validate_axes_titlelocation`, `validate_toolbar`,
`validate_ps_papersize`, `validate_legend_loc`,
`validate_bool_maybe_none`, `validate_hinting`, `validate_movie_writer`,
`validate_webagg_address`, `validate_nseq_float`, `validate_nseq_int`.
To test whether an rcParam value would be acceptable, one can test e.g.
`rc = RcParams(); rc[k] = v` raises an exception.

## Stricter rcParam validation

`axes.axisbelow`{.interpreted-text role="rc"} currently normalizes all
strings starting with \"line\" (case-insensitive) to the option
\"line\". This is deprecated; in a future version only the exact string
\"line\" (case-sensitive) will be supported.

## `add_subplot()` validates its inputs

In particular, for `add_subplot(rows, cols, index)`, all parameters must
be integral. Previously strings and floats were accepted and converted
to int. This will now emit a deprecation warning.

## Toggling axes navigation from the keyboard using \"a\" and digit keys

Axes navigation can still be toggled programmatically using
[.Axes.set_navigate]{.title-ref}.

The following related APIs are also deprecated:
`backend_tools.ToolEnableAllNavigation`,
`backend_tools.ToolEnableNavigation`, and `rcParams["keymap.all_axes"]`.

## `matplotlib.test(recursionlimit=...)`

The *recursionlimit* parameter of `matplotlib.test` is deprecated.

## mathtext glues

The *copy* parameter of `mathtext.Glue` is deprecated (the underlying
glue spec is now immutable). `mathtext.GlueSpec` is deprecated.

## Signatures of [.Artist.draw]{.title-ref} and [matplotlib.axes.Axes.draw]{.title-ref}

The *inframe* parameter to [matplotlib.axes.Axes.draw]{.title-ref} is
deprecated. Use [.Axes.redraw_in_frame]{.title-ref} instead.

Not passing the *renderer* parameter to
[matplotlib.axes.Axes.draw]{.title-ref} is deprecated. Use
`axes.draw_artist(axes)` instead.

These changes make the signature of the `draw` (`artist.draw(renderer)`)
method consistent across all artists; thus, additional parameters to
[.Artist.draw]{.title-ref} are deprecated.

## `DraggableBase.on_motion_blit`

This method is deprecated. [.DraggableBase.on_motion]{.title-ref} now
handles both the blitting and the non-blitting cases.

## Passing the dash offset as None

Fine control of dash patterns can be achieved by passing an
`(offset, (on-length, off-length, on-length, off-length, ...))` pair as
the linestyle property of [.Line2D]{.title-ref} and
[.LineCollection]{.title-ref}. Previously, certain APIs would accept
`offset = None` as a synonym for `offset = 0`, but this was never
universally implemented, e.g. for vector output. Support for
`offset = None` is deprecated, set the offset to 0 instead.

## `RendererCairo.fontweights`, `RendererCairo.fontangles`

\... are deprecated.

## `autofmt_xdate(which=None)`

This is deprecated, use its more explicit synonym, `which="major"`,
instead.

## JPEG options

The *quality*, *optimize*, and *progressive* keyword arguments to
[\~.Figure.savefig]{.title-ref}, which were only used when saving to
JPEG, are deprecated. The `savefig.jpeg_quality` rcParam is likewise
deprecated.

Such options should now be directly passed to Pillow using
`savefig(..., pil_kwargs={"quality": ..., "optimize": ..., "progressive": ...})`.

## `dviread.Encoding`

This class was (mostly) broken and is deprecated.

## Axis and Locator `pan` and `zoom`

The unused `pan` and `zoom` methods of [\~.axis.Axis]{.title-ref} and
[\~.ticker.Locator]{.title-ref} are deprecated. Panning and zooming are
now implemented using the `start_pan`, `drag_pan`, and `end_pan` methods
of [\~.axes.Axes]{.title-ref}.

## Passing None to various Axes subclass factories

Support for passing `None` as base class to
`axes.subplot_class_factory`,
`axes_grid1.parasite_axes.host_axes_class_factory`,
`axes_grid1.parasite_axes.host_subplot_class_factory`,
`axes_grid1.parasite_axes.parasite_axes_class_factory`, and
`axes_grid1.parasite_axes.parasite_axes_auxtrans_class_factory` is
deprecated. Explicitly pass the correct base `Axes` class instead.

## `axes_rgb`

In `mpl_toolkits.axes_grid1.axes_rgb`{.interpreted-text role="mod"},
`imshow_rgb` is deprecated (use `ax.imshow(np.dstack([r, g, b]))`
instead); `RGBAxesBase` is deprecated (use `RGBAxes` instead);
`RGBAxes.add_RGB_to_figure` is deprecated (it was an internal helper).

## `Substitution.from_params`

This method is deprecated. If needed, directly assign to the `params`
attribute of the Substitution object.

## PGF backend cleanups

The *dummy* parameter of [.RendererPgf]{.title-ref} is deprecated.

`GraphicsContextPgf` is deprecated (use
[.GraphicsContextBase]{.title-ref} instead).

## `set_factor` method of `mpl_toolkits.axisartist`{.interpreted-text role="mod"} locators

The `set_factor` method of `mpl_toolkits.axisartist`{.interpreted-text
role="mod"} locators (which are different from \"standard\" Matplotlib
tick locators) is deprecated.

## [.widgets.SubplotTool]{.title-ref} callbacks and axes

The `funcleft`, `funcright`, `funcbottom`, `functop`, `funcwspace`, and
`funchspace` methods of [.widgets.SubplotTool]{.title-ref} are
deprecated.

The `axleft`, `axright`, `axbottom`, `axtop`, `axwspace`, and `axhspace`
attributes of [.widgets.SubplotTool]{.title-ref} are deprecated. Access
the `ax` attribute of the corresponding slider, if needed.

## mathtext `Glue` helper classes

The `Fil`, `Fill`, `Filll`, `NegFil`, `NegFill`, `NegFilll`, and
`SsGlue` classes in the `matplotlib.mathtext`{.interpreted-text
role="mod"} module are deprecated. As an alternative, directly construct
glue instances with `Glue("fil")`, etc.

## NavigationToolbar2.\_init_toolbar

Overriding this method to initialize third-party toolbars is deprecated.
Instead, the toolbar should be initialized in the `__init__` method of
the subclass (which should call the base-class\' `__init__` as
appropriate). To keep back-compatibility with earlier versions of
Matplotlib (which *required* `_init_toolbar` to be overridden), a fully
empty implementation (`def _init_toolbar(self): pass`) may be kept and
will not trigger the deprecation warning.

## NavigationToolbar2QT.parent and .basedir

These attributes are deprecated. In order to access the parent window,
use `toolbar.canvas.parent()`. Once the deprecation period is elapsed,
it will also be accessible as `toolbar.parent()`. The base directory to
the icons is `os.path.join(mpl.get_data_path(), "images")`.

## NavigationToolbar2QT.ctx

This attribute is deprecated.

## NavigationToolbar2Wx attributes

The `prevZoomRect`, `retinaFix`, `savedRetinaImage`, `wxoverlay`,
`zoomAxes`, `zoomStartX`, and `zoomStartY` attributes are deprecated.

## NavigationToolbar2.press and .release

These methods were called when pressing or releasing a mouse button, but
*only* when an interactive pan or zoom was occurring (contrary to what
the docs stated). They are deprecated; if you write a backend which
needs to customize such events, please directly override
`press_pan`/`press_zoom`/`release_pan`/`release_zoom` instead.

## FigureCanvasGTK3.\_renderer_init

Overriding this method to initialize renderers for GTK3 canvases is
deprecated. Instead, the renderer should be initialized in the
`__init__` method of the subclass (which should call the base-class\'
`__init__` as appropriate). To keep back-compatibility with earlier
versions of Matplotlib (which *required* `_renderer_init` to be
overridden), a fully empty implementation
(`def _renderer_init(self): pass`) may be kept and will not trigger the
deprecation warning.

## Path helpers in `.bezier`{.interpreted-text role="mod"}

`bezier.make_path_regular` is deprecated. Use `Path.cleaned()` (or
`Path.cleaned(curves=True)`, etc.) instead (but note that these methods
add a `STOP` code at the end of the path).

`bezier.concatenate_paths` is deprecated. Use
`Path.make_compound_path()` instead.

## `animation.html_args` rcParam

The unused `animation.html_args` rcParam and
`animation.HTMLWriter.args_key` attribute are deprecated.

## `text.latex.preview` rcParam

This rcParam, which controlled the use of the preview.sty LaTeX package
to align TeX string baselines, is deprecated, as Matplotlib\'s own dvi
parser now computes baselines just as well as preview.sty.

## `SubplotSpec.get_rows_columns`

This method is deprecated. Use the `GridSpec.nrows`, `GridSpec.ncols`,
`SubplotSpec.rowspan`, and `SubplotSpec.colspan` properties instead.

## Qt4-based backends

The qt4agg and qt4cairo backends are deprecated. Qt4 has reached its
end-of-life in 2015 and there are no releases for recent versions of
Python. Please consider switching to Qt5.

## *fontdict* and *minor* parameters of [.Axes.set_xticklabels]{.title-ref} and [.Axes.set_yticklabels]{.title-ref} will become keyword-only

## All parameters of [.Figure.subplots]{.title-ref} except *nrows* and *ncols* will become keyword-only

This avoids typing e.g. `subplots(1, 1, 1)` when meaning
`subplot(1, 1, 1)`, but actually getting `subplots(1, 1, sharex=1)`.

## `RendererWx.get_gc`

This method is deprecated. Access the `gc` attribute directly instead.

## *add_all* parameter in `axes_grid`

The *add_all* parameter of [.axes_grid1.axes_grid.Grid]{.title-ref},
[.axes_grid1.axes_grid.ImageGrid]{.title-ref},
[.axes_grid1.axes_rgb.make_rgb_axes]{.title-ref} and
[.axes_grid1.axes_rgb.RGBAxes]{.title-ref} is deprecated. Axes are now
always added to the parent figure, though they can be later removed with
`ax.remove()`.

## `BboxBase.inverse_transformed`

`.BboxBase.inverse_transformed` is deprecated (call
[.BboxBase.transformed]{.title-ref} on the
[\~.Transform.inverted()]{.title-ref} transform instead).

## *orientation* of `eventplot()` and [.EventCollection]{.title-ref}

Setting the *orientation* of an `eventplot()` or
[.EventCollection]{.title-ref} to \"none\" or None is deprecated; set it
to \"horizontal\" instead. Moreover, the two orientations
(\"horizontal\" and \"vertical\") will become case-sensitive in the
future.

## *minor* kwarg to [.Axis.get_ticklocs]{.title-ref} will become keyword-only

Passing this argument positionally is deprecated.

## Case-insensitive properties

Normalization of upper or mixed-case property names to lowercase in
[.Artist.set]{.title-ref} and [.Artist.update]{.title-ref} is
deprecated. In the future, property names will be passed as is, allowing
one to pass names such as *patchA* or *UVC*.

## `ContourSet.ax`, `Quiver.ax`

These attributes are deprecated in favor of `ContourSet.axes` and
`Quiver.axes`, for consistency with other artists.

## `Locator.refresh()` and associated methods

`Locator.refresh()` is deprecated. This method was called at certain
places to let locators update their internal state, typically based on
the axis limits. Locators should now always consult the axis limits when
called, if needed.

The associated helper methods `NavigationToolbar2.draw()` and
`ToolViewsPositions.refresh_locators()` are deprecated, and should be
replaced by calls to `draw_idle()` on the corresponding canvas.

## [.ScalarMappable]{.title-ref} checkers

The `add_checker` and `check_update` methods and `update_dict` attribute
of [.ScalarMappable]{.title-ref} are deprecated.

## [.pyplot.tight_layout]{.title-ref} and `ColorbarBase` parameters will become keyword-only

All parameters of [.pyplot.tight_layout]{.title-ref} and all parameters
of `ColorbarBase` except for the first (*ax*) will become keyword-only,
consistently with [.Figure.tight_layout]{.title-ref} and `Colorbar`,
respectively.

## [.Axes.pie]{.title-ref} radius and startangle

Passing `None` as either the `radius` or `startangle` of an
[.Axes.pie]{.title-ref} is deprecated; use the explicit defaults of 1
and 0, respectively, instead.

## `AxisArtist.dpi_transform`

\... is deprecated. Scale `Figure.dpi_scale_trans` by 1/72 to achieve
the same effect.

## `offset_position` property of [.Collection]{.title-ref}

The `offset_position` property of [.Collection]{.title-ref} is
deprecated. In the future, [.Collection]{.title-ref}s will always behave
as if `offset_position` is set to \"screen\" (the default).

Support for passing `offset_position="data"` to the
`draw_path_collection` of all renderer classes is deprecated.

[.transforms.AffineDeltaTransform]{.title-ref} can be used as a
replacement. This API is experimental and may change in the future.

## `testing.compare.make_external_conversion_command`

\... is deprecated.

## `epoch2num` and `num2epoch` are deprecated

These are unused and can be easily reproduced by other date tools.
[.get_epoch]{.title-ref} will return Matplotlib\'s epoch.

## `axes_grid1.CbarAxes` attributes

The `cbid` and `locator` attribute are deprecated. Use
`mappable.colorbar_cid` and `colorbar.locator`, as for standard
colorbars.

## `qt_compat.is_pyqt5`

This function is deprecated in prevision of the future release of PyQt6.
The Qt version can be checked using `QtCore.qVersion()`.

## Reordering of parameters by [.Artist.set]{.title-ref}

In a future version, `Artist.set` will apply artist properties in the
order in which they are given. This only affects the interaction between
the *color*, *edgecolor*, *facecolor*, and, for
[.Collection]{.title-ref}s, *alpha* properties: the *color* property now
needs to be passed first in order not to override the other properties.
This is consistent with e.g. [.Artist.update]{.title-ref}, which did not
reorder the properties passed to it.

## Passing multiple keys as a single comma-separated string or multiple arguments to [.ToolManager.update_keymap]{.title-ref}

This is deprecated; pass keys as a list of strings instead.

## Statusbar classes and attributes

The `statusbar` attribute of [.FigureManagerBase]{.title-ref},
`StatusbarBase` and all its subclasses, and `StatusBarWx`, are
deprecated, as messages are now displayed in the toolbar instead.

## `ismath` parameter of `draw_tex`

The `ismath` parameter of the `draw_tex` method of all renderer classes
is deprecated (as a call to `draw_tex` \-- not to be confused with
`draw_text`! \-- means that the entire string should be passed to the
`usetex` machinery anyways). Likewise, the text machinery will no longer
pass the `ismath` parameter when calling `draw_tex` (this should only
matter for backend implementers).

Passing `ismath="TeX!"` to
[.RendererAgg.get_text_width_height_descent]{.title-ref} is deprecated.
Pass `ismath="TeX"` instead, consistently with other low-level APIs
which support the values True, False, and \"TeX\" for `ismath`.

## `matplotlib.ttconv`

This module is deprecated.

## Stricter PDF metadata keys in PGF

Saving metadata in PDF with the PGF backend currently normalizes all
keys to lowercase, unlike the PDF backend, which only accepts the
canonical case. This is deprecated; in a future version, only the
canonically cased keys listed in the PDF specification (and the
[\~.backend_pgf.PdfPages]{.title-ref} documentation) will be accepted.

## Qt modifier keys

The `MODIFIER_KEYS`, `SUPER`, `ALT`, `CTRL`, and `SHIFT` global
variables of the `matplotlib.backends.backend_qt4agg`,
`matplotlib.backends.backend_qt4cairo`,
`matplotlib.backends.backend_qt5agg`{.interpreted-text role="mod"} and
`matplotlib.backends.backend_qt5cairo`{.interpreted-text role="mod"}
modules are deprecated.

## `TexManager`

The `TexManager.serif`, `TexManager.sans_serif`, `TexManager.cursive`
and `TexManager.monospace` attributes are deprecated.