`__
+
+The following 17 authors contributed 130 commits.
+
+* amiraflak
+* Amirreza Aflakparast
+* dependabot[bot]
+* Elliott Sales de Andrade
+* Greg Lucas
+* hannah
+* Haoying Zhang
+* Jody Klymak
+* Kritika Verma
+* Kyle Sunden
+* marbled-toast
+* Mateusz Sokół
+* Matthew Feickert
+* Oscar Gustafsson
+* Ruth Comer
+* Thomas A Caswell
+* Tim Hoffmann
+
+GitHub issues and pull requests:
+
+Pull Requests (48):
+
+* :ghpull:`26725`: Backport PR #26719 on branch v3.7.x (Fix issue with missing attribute in Path3DCollection)
+* :ghpull:`26723`: Backport PR #26721 on branch v3.7.x (Add a Python 3.12 classifier)
+* :ghpull:`26719`: Fix issue with missing attribute in Path3DCollection
+* :ghpull:`26721`: Add a Python 3.12 classifier
+* :ghpull:`26672`: Backport cibuildwheel updates to v3.7.x
+* :ghpull:`26706`: Pin NumPy below v2 for 3.7.x
+* :ghpull:`26653`: Backport PR #26597 on branch v3.7.x (Squeeze post-converted values when validating limits)
+* :ghpull:`26597`: Squeeze post-converted values when validating limits
+* :ghpull:`26582`: MNT: Enable wheels for Python 3.12
+* :ghpull:`26616`: Backport PR #26598 on branch v3.7.x (FIX: array labelcolor for Tick)
+* :ghpull:`26598`: FIX: array labelcolor for Tick
+* :ghpull:`26610`: Backport PR #26538 on branch v3.7.x (Resolves #26421 Added an example for fig comparison decorator)
+* :ghpull:`26538`: Resolves #26421 Added an example for fig comparison decorator
+* :ghpull:`26574`: Backport PR #26571 on branch v3.7.x ([Doc]: match 3D plot types with others)
+* :ghpull:`26571`: [Doc]: match 3D plot types with others
+* :ghpull:`26570`: Backport PR #26569 on branch v3.7.x (refactor: constant "ncols" to variables)
+* :ghpull:`26569`: refactor: constant "ncols" to variables
+* :ghpull:`26555`: Backport PR #26554 on branch v3.7.x (Remove NumPy abs overrides from pylab)
+* :ghpull:`26552`: Backport PR #26493: Disable ````add_html_cache_busting```` on Sphinx 7.1+
+* :ghpull:`26554`: Remove NumPy abs overrides from pylab
+* :ghpull:`26549`: Backport PR #26545 on branch v3.7.x (Fix size inferral when using cairocffi)
+* :ghpull:`26545`: Fix size inferral when using cairocffi
+* :ghpull:`26544`: Backport PR #26532: Fix input check in Poly3DCollection.__init__
+* :ghpull:`26532`: Fix input check in Poly3DCollection.__init__
+* :ghpull:`26459`: Backport PR #26458 on branch v3.7.x (Remove soon to be deprecated nan/inf aliases)
+* :ghpull:`26458`: Remove soon to be deprecated nan/inf aliases
+* :ghpull:`26455`: Backport PR #26452 on branch v3.7.x (ENH: Update numpy exceptions imports)
+* :ghpull:`26452`: ENH: Update numpy exceptions imports
+* :ghpull:`26439`: Backport PR #26436 on branch v3.7.x (DOC: Add a warning that ticks are not persistent)
+* :ghpull:`26432`: Backport PR #26431 on branch v3.7.x (MNT: Unpin pyparsing, xfail error message tests for pyparsing 3.1.0)
+* :ghpull:`26436`: DOC: Add a warning that ticks are not persistent
+* :ghpull:`26428`: Merge branch v3.7.2-doc into v3.7.x
+* :ghpull:`26431`: MNT: Unpin pyparsing, xfail error message tests for pyparsing 3.1.0
+* :ghpull:`26412`: Backport PR #26405 on branch v3.7.x (DOC: Clarify the difference between document and section references)
+* :ghpull:`26390`: Backport PR #26354 on branch v3.7.x (DOC: contourf antialiased default)
+* :ghpull:`26354`: DOC: contourf antialiased default
+* :ghpull:`26386`: Backport PR #26370 on branch v3.7.x (Update README.txt )
+* :ghpull:`26364`: Backport PR #26361 on branch v3.7.x (LIC: Update the license we bundle the colorbrewer colormap data with)
+* :ghpull:`26361`: LIC: Update the license we bundle the colorbrewer colormap data with
+* :ghpull:`26322`: Backport PR #26321 on branch v3.7.x (remove quote box from font_manager)
+* :ghpull:`26318`: Backport PR #26317 on branch v3.7.x (update the doc string for fancyarrowpatch to link to annotate)
+* :ghpull:`26317`: update the doc string for fancyarrowpatch to link to annotate
+* :ghpull:`26304`: Backport PR #26300 on branch v3.7.x (FIX: do not warn when calling tight_layout multiple times)
+* :ghpull:`26300`: FIX: do not warn when calling tight_layout multiple times
+* :ghpull:`26301`: Backport PR #26291 on branch v3.7.x (Get correct renderer for axes_grid1 inset axes with bbox_inches=tight)
+* :ghpull:`26298`: Backport PR #26195 on branch v3.7.x ([Doc] link style sheets reference to customization tutorial)
+* :ghpull:`26291`: Get correct renderer for axes_grid1 inset axes with bbox_inches=tight
+* :ghpull:`26267`: Backport PR #26266 on branch v3.7.x (DOC: Use consistent font for anatomy example)
+
+Issues (14):
+
+* :ghissue:`26732`: [ENH]: Parser errors should mention that commands do not exist
+* :ghissue:`26497`: [Bug]: AttributeError: 'Path3DCollection' object has no attribute '_offset_zordered' (possible regression)
+* :ghissue:`26588`: [Bug]: Tick class instantiation returns an error when labelcolor is a tuple
+* :ghissue:`26421`: [Doc]: demo testing comparison decorator
+* :ghissue:`26486`: [Doc]: match 3D plot types listings titles to other titles
+* :ghissue:`26560`: [Doc]: ncols parameter hard-coded
+* :ghissue:`26553`: [TST] Upcoming dependency test failures
+* :ghissue:`26523`: [Bug]: backend_cairo set_context() is broken for cairocffi
+* :ghissue:`26420`: Typo in Poly3DCollection constructor
+* :ghissue:`26152`: [Bug]: Pyparsing 3.1 breaks tests
+* :ghissue:`26336`: [Doc]: GPL compatibility
+* :ghissue:`19721`: head size of FancyArrowPatch is "invisibly small" by default
+* :ghissue:`26290`: [Bug]: calling fig.tight_layout multiple times
+* :ghissue:`26287`: [Bug]: Error while creating inset axes using ``mpl_toolkits.axes_grid1.inset_locator.inset_axes``
diff --git a/doc/users/prev_whats_new/whats_new_1.4.rst b/doc/users/prev_whats_new/whats_new_1.4.rst
index b8a85638646b..39eefa81b168 100644
--- a/doc/users/prev_whats_new/whats_new_1.4.rst
+++ b/doc/users/prev_whats_new/whats_new_1.4.rst
@@ -46,7 +46,7 @@ same way as any other matplotlib backend. Because figures require a connection
to the IPython notebook server for their interactivity, once the notebook is
saved, each figure will be rendered as a static image - thus allowing
non-interactive viewing of figures on services such as
-`nbviewer `__.
+`nbviewer `__.
diff --git a/doc/users/prev_whats_new/whats_new_3.8.0.rst b/doc/users/prev_whats_new/whats_new_3.8.0.rst
new file mode 100644
index 000000000000..ab5a0dce85da
--- /dev/null
+++ b/doc/users/prev_whats_new/whats_new_3.8.0.rst
@@ -0,0 +1,525 @@
+==============================================
+What's new in Matplotlib 3.8.0 (Sept 13, 2023)
+==============================================
+
+For a list of all of the issues and pull requests since the last revision, see
+the :ref:`github-stats`.
+
+.. contents:: Table of Contents
+ :depth: 4
+
+.. toctree::
+ :maxdepth: 4
+
+Type Hints
+==========
+
+Matplotlib now provides first-party PEP484 style type hints files for most public APIs.
+
+While still considered provisional and subject to change (and sometimes we are not
+quite able to fully specify what we would like to), they should provide a reasonable
+basis to type check many common usage patterns, as well as integrating with many
+editors/IDEs.
+
+Plotting and Annotation improvements
+====================================
+
+Support customizing antialiasing for text and annotation
+--------------------------------------------------------
+``matplotlib.pyplot.annotate()`` and ``matplotlib.pyplot.text()`` now support parameter *antialiased*.
+When *antialiased* is set to ``True``, antialiasing will be applied to the text.
+When *antialiased* is set to ``False``, antialiasing will not be applied to the text.
+When *antialiased* is not specified, antialiasing will be set by :rc:`text.antialiased` at the creation time of ``Text`` and ``Annotation`` object.
+Examples:
+
+.. code-block:: python
+
+ mpl.text.Text(.5, .5, "foo\nbar", antialiased=True)
+ plt.text(0.5, 0.5, '6 inches x 2 inches', antialiased=True)
+ ax.annotate('local max', xy=(2, 1), xytext=(3, 1.5), antialiased=False)
+
+If the text contains math expression, *antialiased* applies to the whole text.
+Examples:
+
+.. code-block:: python
+
+ # no part will be antialiased for the text below
+ plt.text(0.5, 0.25, r"$I'm \sqrt{x}$", antialiased=False)
+
+Also note that antialiasing for tick labels will be set with :rc:`text.antialiased` when they are created (usually when a ``Figure`` is created) and cannot be changed afterwards.
+
+Furthermore, with this new feature, you may want to make sure that you are creating and saving/showing the figure under the same context::
+
+ # previously this was a no-op, now it is what works
+ with rccontext(text.antialiased=False):
+ fig, ax = plt.subplots()
+ ax.annotate('local max', xy=(2, 1), xytext=(3, 1.5))
+ fig.savefig('/tmp/test.png')
+
+
+ # previously this had an effect, now this is a no-op
+ fig, ax = plt.subplots()
+ ax.annotate('local max', xy=(2, 1), xytext=(3, 1.5))
+ with rccontext(text.antialiased=False):
+ fig.savefig('/tmp/test.png')
+
+rcParams for ``AutoMinorLocator`` divisions
+-------------------------------------------
+The rcParams :rc:`xtick.minor.ndivs` and :rc:`ytick.minor.ndivs` have been
+added to enable setting the default number of divisions; if set to ``auto``,
+the number of divisions will be chosen by the distance between major ticks.
+
+Axline setters and getters
+--------------------------
+
+The returned object from `.axes.Axes.axline` now supports getter and setter
+methods for its *xy1*, *xy2* and *slope* attributes:
+
+.. code-block:: python
+
+ line1.get_xy1()
+ line1.get_slope()
+ line2.get_xy2()
+
+.. code-block:: python
+
+ line1.set_xy1(.2, .3)
+ line1.set_slope(2.4)
+ line2.set_xy2(.1, .6)
+
+Clipping for contour plots
+--------------------------
+
+`~.Axes.contour` and `~.Axes.contourf` now accept the *clip_path* parameter.
+
+.. plot::
+ :include-source: true
+
+ import numpy as np
+ import matplotlib.pyplot as plt
+ import matplotlib.patches as mpatches
+
+ x = y = np.arange(-3.0, 3.01, 0.025)
+ X, Y = np.meshgrid(x, y)
+ Z1 = np.exp(-X**2 - Y**2)
+ Z2 = np.exp(-(X - 1)**2 - (Y - 1)**2)
+ Z = (Z1 - Z2) * 2
+
+ fig, ax = plt.subplots()
+ patch = mpatches.RegularPolygon((0, 0), 5, radius=2,
+ transform=ax.transData)
+ ax.contourf(X, Y, Z, clip_path=patch)
+
+ plt.show()
+
+``Axes.ecdf``
+-------------
+A new Axes method, `~.Axes.ecdf`, allows plotting empirical cumulative
+distribution functions without any binning.
+
+.. plot::
+ :include-source:
+
+ import matplotlib.pyplot as plt
+ import numpy as np
+
+ fig, ax = plt.subplots()
+ ax.ecdf(np.random.randn(100))
+
+``Figure.get_suptitle()``, ``Figure.get_supxlabel()``, ``Figure.get_supylabel()``
+---------------------------------------------------------------------------------
+These methods return the strings set by ``Figure.suptitle()``, ``Figure.supxlabel()``
+and ``Figure.supylabel()`` respectively.
+
+``Ellipse.get_vertices()``, ``Ellipse.get_co_vertices()``
+---------------------------------------------------------------------------------
+These methods return the coordinates of ellipse vertices of
+major and minor axis. Additionally, an example gallery demo is added which
+shows how to add an arrow to an ellipse showing a clockwise or counter-clockwise
+rotation of the ellipse. To place the arrow exactly on the ellipse,
+the coordinates of the vertices are used.
+
+Remove inner ticks in ``label_outer()``
+---------------------------------------
+Up to now, ``label_outer()`` has only removed the ticklabels. The ticks lines
+were left visible. This is now configurable through a new parameter
+``label_outer(remove_inner_ticks=True)``.
+
+
+.. plot::
+ :include-source: true
+
+ import numpy as np
+ import matplotlib.pyplot as plt
+
+ x = np.linspace(0, 2 * np.pi, 100)
+
+ fig, axs = plt.subplots(2, 2, sharex=True, sharey=True,
+ gridspec_kw=dict(hspace=0, wspace=0))
+
+ axs[0, 0].plot(x, np.sin(x))
+ axs[0, 1].plot(x, np.cos(x))
+ axs[1, 0].plot(x, -np.cos(x))
+ axs[1, 1].plot(x, -np.sin(x))
+
+ for ax in axs.flat:
+ ax.grid(color='0.9')
+ ax.label_outer(remove_inner_ticks=True)
+
+Configurable legend shadows
+---------------------------
+The *shadow* parameter of legends now accepts dicts in addition to booleans.
+Dictionaries can contain any keywords for `.patches.Patch`.
+For example, this allows one to set the color and/or the transparency of a legend shadow:
+
+.. code-block:: python
+
+ ax.legend(loc='center left', shadow={'color': 'red', 'alpha': 0.5})
+
+and to control the shadow location:
+
+.. code-block:: python
+
+ ax.legend(loc='center left', shadow={"ox":20, "oy":-20})
+
+Configuration is currently not supported via :rc:`legend.shadow`.
+
+
+``offset`` parameter for MultipleLocator
+----------------------------------------
+
+An *offset* may now be specified to shift all the ticks by the given value.
+
+.. plot::
+ :include-source: true
+
+ import matplotlib.pyplot as plt
+ import matplotlib.ticker as mticker
+
+ _, ax = plt.subplots()
+ ax.plot(range(10))
+ locator = mticker.MultipleLocator(base=3, offset=0.3)
+ ax.xaxis.set_major_locator(locator)
+
+ plt.show()
+
+Add a new valid color format ``(matplotlib_color, alpha)``
+----------------------------------------------------------
+
+
+.. plot::
+ :include-source: true
+
+ import matplotlib.pyplot as plt
+ from matplotlib.patches import Rectangle
+
+ fig, ax = plt.subplots()
+
+ rectangle = Rectangle((.2, .2), .6, .6,
+ facecolor=('blue', 0.2),
+ edgecolor=('green', 0.5))
+ ax.add_patch(rectangle)
+
+
+Users can define a color using the new color specification, *(matplotlib_color, alpha)*.
+Note that an explicit alpha keyword argument will override an alpha value from
+*(matplotlib_color, alpha)*.
+
+The pie chart shadow can be controlled
+--------------------------------------
+
+The *shadow* argument to `~.Axes.pie` can now be a dict, allowing more control
+of the `.Shadow`-patch used.
+
+
+``PolyQuadMesh`` is a new class for drawing quadrilateral meshes
+----------------------------------------------------------------
+
+`~.Axes.pcolor` previously returned a flattened `.PolyCollection` with only
+the valid polygons (unmasked) contained within it. Now, we return a `.PolyQuadMesh`,
+which is a mixin incorporating the usefulness of 2D array and mesh coordinates
+handling, but still inheriting the draw methods of `.PolyCollection`, which enables
+more control over the rendering properties than a normal `.QuadMesh` that is
+returned from `~.Axes.pcolormesh`. The new class subclasses `.PolyCollection` and thus
+should still behave the same as before. This new class keeps track of the mask for
+the user and updates the Polygons that are sent to the renderer appropriately.
+
+.. plot::
+
+ arr = np.arange(12).reshape((3, 4))
+
+ fig, ax = plt.subplots()
+ pc = ax.pcolor(arr)
+
+ # Mask one element and show that the hatch is also not drawn
+ # over that region
+ pc.set_array(np.ma.masked_equal(arr, 5))
+ pc.set_hatch('//')
+
+ plt.show()
+
+Shadow shade can be controlled
+------------------------------
+
+The `.Shadow` patch now has a *shade* argument to control the shadow darkness.
+If 1, the shadow is black, if 0, the shadow has the same color as the patch that
+is shadowed. The default value, which earlier was fixed, is 0.7.
+
+``SpinesProxy`` now supports calling the ``set()`` method
+---------------------------------------------------------
+One can now call e.g. ``ax.spines[:].set(visible=False)``.
+
+Allow setting the tick label fonts with a keyword argument
+----------------------------------------------------------
+``Axes.tick_params`` now accepts a *labelfontfamily* keyword that changes the tick
+label font separately from the rest of the text objects:
+
+.. code-block:: python
+
+ Axis.tick_params(labelfontfamily='monospace')
+
+
+Figure, Axes, and Legend Layout
+===============================
+
+pad_inches="layout" for savefig
+-------------------------------
+
+When using constrained or compressed layout,
+
+.. code-block:: python
+
+ savefig(filename, bbox_inches="tight", pad_inches="layout")
+
+will now use the padding sizes defined on the layout engine.
+
+Add a public method to modify the location of ``Legend``
+--------------------------------------------------------
+
+`~matplotlib.legend.Legend` locations now can be tweaked after they've been defined.
+
+.. plot::
+ :include-source: true
+
+ from matplotlib import pyplot as plt
+
+ fig = plt.figure()
+ ax = fig.add_subplot(1, 1, 1)
+
+ x = list(range(-100, 101))
+ y = [i**2 for i in x]
+
+ ax.plot(x, y, label="f(x)")
+ ax.legend()
+ ax.get_legend().set_loc("right")
+ # Or
+ # ax.get_legend().set(loc="right")
+
+ plt.show()
+
+
+``rcParams['legend.loc']`` now accepts float-tuple inputs
+---------------------------------------------------------
+
+The :rc:`legend.loc` rcParams now accepts float-tuple inputs, same as the *loc* keyword argument to `.Legend`.
+This allows users to set the location of the legend in a more flexible and consistent way.
+
+Mathtext improvements
+=====================
+
+Boldsymbol mathtext command ``\boldsymbol``
+-------------------------------------------
+
+Supports using the ``\boldsymbol{}`` command in mathtext:
+
+To change symbols to bold enclose the text in a font command as
+shown:
+
+.. code-block:: none
+
+ r'$\boldsymbol{a+2+\alpha}$'
+
+.. math::
+ \boldsymbol{a+2+\alpha}
+
+``mathtext`` has more sizable delimiters
+----------------------------------------
+
+The ``\lgroup`` and ``\rgroup`` sizable delimiters have been added.
+
+The following delimiter names have been supported earlier, but can now be sized with
+``\left`` and ``\right``:
+
+* ``\lbrace``, ``\rbrace``, ``\leftbrace``, and ``\rightbrace``
+* ``\lbrack`` and ``\rbrack``
+* ``\leftparen`` and ``\rightparen``
+
+There are really no obvious advantages in using these.
+Instead, they are are added for completeness.
+
+``mathtext`` documentation improvements
+---------------------------------------
+
+The documentation is updated to take information directly from the parser. This
+means that (almost) all supported symbols, operators etc are shown at :ref:`mathtext`.
+
+``mathtext`` now supports ``\substack``
+---------------------------------------
+
+``\substack`` can be used to create multi-line subscripts or superscripts within an equation.
+
+To use it to enclose the math in a substack command as shown:
+
+.. code-block:: none
+
+ r'$\sum_{\substack{1\leq i\leq 3\\ 1\leq j\leq 5}}$'
+
+.. mathmpl::
+
+ \sum_{\substack{1\leq i\leq 3\\ 1\leq j\leq 5}}
+
+
+
+``mathtext`` now supports ``\middle`` delimiter
+-----------------------------------------------
+
+The ``\middle`` delimiter has been added, and can now be used with the
+``\left`` and ``\right`` delimiters:
+
+To use the middle command enclose it in between the ``\left`` and
+``\right`` delimiter command as shown:
+
+.. code-block:: none
+
+ r'$\left( \frac{a}{b} \middle| q \right)$'
+
+.. mathmpl::
+
+ \left( \frac{a}{b} \middle| q \right)
+
+``mathtext`` operators
+----------------------
+
+There has been a number of operators added and corrected when a Unicode font is used.
+In addition, correct spacing has been added to a number of the previous operators.
+Especially, the characters used for ``\gnapprox``, ``\lnapprox``, ``\leftangle``, and
+``\rightangle`` have been corrected.
+
+``mathtext`` spacing corrections
+--------------------------------
+
+As consequence of the updated documentation, the spacing on a number of relational and
+operator symbols were classified like that and therefore will be spaced properly.
+
+``mathtext`` now supports ``\text``
+-----------------------------------
+
+``\text`` can be used to obtain upright text within an equation and to get a plain dash
+(-).
+
+.. plot::
+ :include-source: true
+ :alt: Illustration of the newly added \text command, showing that it renders as normal text, including spaces, despite being part of an equation. Also show that a dash is not rendered as a minus when part of a \text command.
+
+ import matplotlib.pyplot as plt
+ plt.text(0.1, 0.5, r"$a = \sin(\phi) \text{ such that } \phi = \frac{x}{y}$")
+ plt.text(0.1, 0.3, r"$\text{dashes (-) are retained}$")
+
+
+Bold-italic mathtext command ``\mathbfit``
+------------------------------------------
+
+Supports use of bold-italic font style in mathtext using the ``\mathbfit{}`` command:
+
+To change font to bold and italic enclose the text in a font command as
+shown:
+
+.. code-block:: none
+
+ r'$\mathbfit{\eta \leq C(\delta(\eta))}$
+
+.. math::
+ \mathbfit{\eta \leq C(\delta(\eta))}
+
+
+3D plotting improvements
+========================
+
+Specify ticks and axis label positions for 3D plots
+---------------------------------------------------
+
+You can now specify the positions of ticks and axis labels for 3D plots.
+
+.. plot::
+ :include-source:
+
+ import matplotlib.pyplot as plt
+
+ positions = ['lower', 'upper', 'default', 'both', 'none']
+ fig, axs = plt.subplots(2, 3, figsize=(12, 8),
+ subplot_kw={'projection': '3d'})
+ for ax, pos in zip(axs.flatten(), positions):
+ for axis in ax.xaxis, ax.yaxis, ax.zaxis:
+ axis.set_label_position(pos)
+ axis.set_ticks_position(pos)
+ title = f'position="{pos}"'
+ ax.set(xlabel='x', ylabel='y', zlabel='z', title=title)
+ axs[1, 2].axis('off')
+
+3D hover coordinates
+--------------------
+
+The x, y, z coordinates displayed in 3D plots were previously showing
+nonsensical values. This has been fixed to report the coordinate on the view
+pane directly beneath the mouse cursor. This is likely to be most useful when
+viewing 3D plots along a primary axis direction when using an orthographic
+projection, or when a 2D plot has been projected onto one of the 3D axis panes.
+Note that there is still no way to directly display the coordinates of plotted
+data points.
+
+3D plots can share view angles
+------------------------------
+
+3D plots can now share the same view angles, so that when you rotate one plot
+the other plots also rotate. This can be done with the *shareview* keyword
+argument when adding an axes, or by using the *ax1.shareview(ax2)* method of
+existing 3D axes.
+
+
+Other improvements
+==================
+
+macosx: New figures can be opened in either windows or tabs
+-----------------------------------------------------------
+
+There is a new :rc:`macosx.window_mode`` rcParam to control how
+new figures are opened with the macosx backend. The default is
+**system** which uses the system settings, or one can specify either
+**tab** or **window** to explicitly choose the mode used to open new figures.
+
+``matplotlib.mpl_toolkits`` is now an implicit namespace package
+----------------------------------------------------------------
+
+Following the deprecation of ``pkg_resources.declare_namespace`` in ``setuptools`` 67.3.0,
+``matplotlib.mpl_toolkits`` is now implemented as an implicit namespace, following
+`PEP 420 `_.
+
+Plot Directive now can make responsive images with "srcset"
+-----------------------------------------------------------
+
+The plot sphinx directive (``matplotlib.sphinxext.plot_directive``, invoked in
+rst as ``.. plot::``) can be configured to automatically make higher res
+figures and add these to the the built html docs. In ``conf.py``::
+
+ extensions = [
+ ...
+ 'matplotlib.sphinxext.plot_directive',
+ 'matplotlib.sphinxext.figmpl_directive',
+ ...]
+
+ plot_srcset = ['2x']
+
+will make png files with double the resolution for hiDPI displays. Resulting
+html files will have image entries like::
+
+ 
diff --git a/doc/users/project/citing.rst b/doc/users/project/citing.rst
index 66a829a1eb67..2230ecf1463c 100644
--- a/doc/users/project/citing.rst
+++ b/doc/users/project/citing.rst
@@ -29,6 +29,12 @@ By version
.. START OF AUTOGENERATED
+v3.8.0
+ .. image:: ../../_static/zenodo_cache/8347255.svg
+ :target: https://doi.org/10.5281/zenodo.8347255
+v3.7.3
+ .. image:: ../../_static/zenodo_cache/8336761.svg
+ :target: https://doi.org/10.5281/zenodo.8336761
v3.7.2
.. image:: ../../_static/zenodo_cache/8118151.svg
:target: https://doi.org/10.5281/zenodo.8118151
diff --git a/doc/users/release_notes.rst b/doc/users/release_notes.rst
index b2abd3ae79fe..1d281543b76c 100644
--- a/doc/users/release_notes.rst
+++ b/doc/users/release_notes.rst
@@ -12,6 +12,15 @@ Release notes
.. include:: release_notes_next.rst
+Version 3.8
+===========
+.. toctree::
+ :maxdepth: 1
+
+ prev_whats_new/whats_new_3.8.0.rst
+ ../api/prev_api_changes/api_changes_3.8.0.rst
+ github_stats.rst
+
Version 3.7
===========
.. toctree::
@@ -19,7 +28,8 @@ Version 3.7
prev_whats_new/whats_new_3.7.0.rst
../api/prev_api_changes/api_changes_3.7.0.rst
- github_stats.rst
+ prev_whats_new/github_stats_3.7.3.rst
+ prev_whats_new/github_stats_3.7.2.rst
prev_whats_new/github_stats_3.7.1.rst
prev_whats_new/github_stats_3.7.0.rst
diff --git a/galleries/users_explain/figure/backends.rst b/galleries/users_explain/figure/backends.rst
index eba03997fa75..b769fcc12ba2 100644
--- a/galleries/users_explain/figure/backends.rst
+++ b/galleries/users_explain/figure/backends.rst
@@ -211,7 +211,7 @@ wxAgg Agg rendering to a wxWidgets_ canvas (requires wxPython_ 4).
.. _Cairo: https://www.cairographics.org
.. _PyGObject: https://wiki.gnome.org/action/show/Projects/PyGObject
.. _pycairo: https://www.cairographics.org/pycairo/
-.. _cairocffi: https://pythonhosted.org/cairocffi/
+.. _cairocffi: https://doc.courtbouillon.org/cairocffi/stable/
.. _wxPython: https://www.wxpython.org/
.. _TkInter: https://docs.python.org/3/library/tk.html
.. _PyQt: https://riverbankcomputing.com/software/pyqt/intro
diff --git a/galleries/users_explain/figure/figure_intro.rst b/galleries/users_explain/figure/figure_intro.rst
index 5f7db3d0202c..000828bdee0b 100644
--- a/galleries/users_explain/figure/figure_intro.rst
+++ b/galleries/users_explain/figure/figure_intro.rst
@@ -91,7 +91,7 @@ backend. These are typically chosen either in the user's :ref:`matplotlibrc
QtAgg backend.
When run from a script, or interactively (e.g. from an
-`iPython shell `_) the Figure
+`iPython shell `_) the Figure
will not be shown until we call ``plt.show()``. The Figure will appear in
a new GUI window, and usually will have a toolbar with Zoom, Pan, and other tools
for interacting with the Figure. By default, ``plt.show()`` blocks
diff --git a/requirements/doc/doc-requirements.txt b/requirements/doc/doc-requirements.txt
index 356d5cde7596..c0b4a19e3dd3 100644
--- a/requirements/doc/doc-requirements.txt
+++ b/requirements/doc/doc-requirements.txt
@@ -15,7 +15,7 @@ ipykernel
numpydoc>=1.0
packaging>=20
pydata-sphinx-theme~=0.13.1
-mpl-sphinx-theme~=3.7.0
+mpl-sphinx-theme~=3.8.0
pyyaml
sphinxcontrib-svg2pdfconverter>=1.1.0
sphinx-gallery>=0.12.0
diff --git a/tools/cache_zenodo_svg.py b/tools/cache_zenodo_svg.py
index 7d7a51280133..2058701e5999 100644
--- a/tools/cache_zenodo_svg.py
+++ b/tools/cache_zenodo_svg.py
@@ -63,6 +63,8 @@ def _get_xdg_cache_dir():
if __name__ == "__main__":
data = {
+ "v3.8.0": "8347255",
+ "v3.7.3": "8336761",
"v3.7.2": "8118151",
"v3.7.1": "7697899",
"v3.7.0": "7637593",
pFad - Phonifier reborn
Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.
Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.
Alternative Proxies:
Alternative Proxy
pFad Proxy
pFad v3 Proxy
pFad v4 Proxy