Add api changes and what new docs

ianthomas23 · ianthomas23 · commit 67bec5be504c · 2024-02-27T11:15:56.000Z
diff --git a/doc/api/backend_registry_api.rst b/doc/api/backend_registry_api.rst
@@ -0,0 +1,8 @@
+********************************
+``matplotlib.backends.registry``
+********************************
+
+.. automodule:: matplotlib.backends.registry
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/doc/api/index_backend_api.rst b/doc/api/index_backend_api.rst
@@ -17,6 +17,7 @@
    backend_pdf_api.rst
    backend_pgf_api.rst
    backend_ps_api.rst
+   backend_registry_api.rst
    backend_qt_api.rst
    backend_svg_api.rst
    backend_tk_api.rst
diff --git a/doc/api/next_api_changes/deprecations/27719-IT.rst b/doc/api/next_api_changes/deprecations/27719-IT.rst
@@ -0,0 +1,12 @@
+`~.rcsetup.interactive_bk`, `~.rcsetup.non_interactive_bk` and `~.rcsetup.all_backends`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+... are deprecated and replaced by
+:meth:`matplotlib.backends.registry.backend_registry.list_builtin`
+with the following arguments
+
+- `matplotlib.backends.registry.BackendFilter.INTERACTIVE`
+- `matplotlib.backends.registry.BackendFilter.NON_INTERACTIVE`
+- ``None``
+
+respectively.
diff --git a/doc/users/next_whats_new/backend_registry.rst b/doc/users/next_whats_new/backend_registry.rst
@@ -0,0 +1,5 @@
+BackendRegistry
+~~~~~~~~~~~~~~~
+
+New `~/.BackendRegistry` class is the single source of truth for available
+backends. The singleton instance is `matplotlib.backends.registry.backend_registry`.
