DOC: Consolidate API development changes for 3.9

Author: QuLogic

doc/api/next_api_changes/development/26800-OG.rst

@@ -0,0 +1,8 @@
+API Changes for 3.9.0
+=====================
+
+.. contents::
+   :local:
+   :depth: 1
+
+.. include:: /api/prev_api_changes/api_changes_3.9.0/development.rst

doc/api/next_api_changes/development/26849-KS.rst

@@ -1,5 +1,8 @@
+Development changes
+-------------------
+
 Build system ported to Meson
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 The build system of Matplotlib has been ported from setuptools to `meson-python
 <https://meson-python.readthedocs.io>`_ and `Meson <https://mesonbuild.com>`_.
@@ -26,7 +29,7 @@ Consequently, there have been a few changes for development and packaging purpos
 
    may be replaced by passing the following arguments to ``pip``::
 
-      --config-settings=setup-args="-DrcParams-backend=Agg" \
+      --config-settings=setup-args="-DrcParams-backend=Agg"
       --config-settings=setup-args="-Dsystem-qhull=true"
 
    Note that you must use ``pip`` >= 23.1 in order to pass more than one setting.
@@ -37,10 +40,45 @@ Consequently, there have been a few changes for development and packaging purpos
    <https://mesonbuild.com/Builtin-options.html#details-for-vsenv>`_ if you wish to
    change the priority of chosen compilers.
 5. Installation of test data was previously controlled by :file:`mplsetup.cfg`, but has
-   now been moved to Meson's install tags. To install test data, add the ``tests``
-   tag to the requested install (be sure to include the existing tags as below)::
+   now been moved to Meson's install tags. To install test data, add the ``tests`` tag
+   to the requested install (be sure to include the existing tags as below)::
 
       --config-settings=install-args="--tags=data,python-runtime,runtime,tests"
 6. Checking typing stubs with ``stubtest`` does not work easily with editable install.
    For the time being, we suggest using a normal (non-editable) install if you wish to
    run ``stubtest``.
+
+Increase to minimum supported versions of dependencies
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+For Matplotlib 3.9, the :ref:`minimum supported versions <dependencies>` are being
+bumped:
+
++------------+-----------------+---------------+
+| Dependency |  min in mpl3.8  | min in mpl3.9 |
++============+=================+===============+
+|   NumPy    |       1.21.0    |      1.23.0   |
++------------+-----------------+---------------+
+| setuptools |       42        |      64       |
++------------+-----------------+---------------+
+
+This is consistent with our :ref:`min_deps_policy` and `SPEC 0
+<https://scientific-python.org/specs/spec-0000/>`__.
+
+To comply with requirements of ``setuptools_scm``, the minimum version of ``setuptools``
+has been increased from 42 to 64.
+
+Extensions require C++17
+^^^^^^^^^^^^^^^^^^^^^^^^
+
+Matplotlib now requires a compiler that supports C++17 in order to build its extensions.
+According to `SciPy's analysis
+<https://docs.scipy.org/doc/scipy/dev/toolchain.html#c-language-standards>`_, this
+should be available on all supported platforms.
+
+Windows on ARM64 support
+^^^^^^^^^^^^^^^^^^^^^^^^
+
+Windows on ARM64 now bundles FreeType 2.6.1 instead of 2.11.1 when building from source.
+This may cause small changes to text rendering, but should become consistent with all
+other platforms.

doc/api/next_api_changes/development/27012-ES.rst

@@ -19,7 +19,7 @@ Version 3.9
     :maxdepth: 1
 
     next_whats_new
-    ../api/next_api_changes
+    ../api/prev_api_changes/api_changes_3.9.0.rst
     github_stats.rst
 
 Version 3.8