[Python-checkins] bpo-44246: Update What's New for importlib.metadata. (#26408)

[jaraco]

https://github.com/python/cpython/commit/28f12c9f4f39d283d823d81e311d863526dfdb54
commit: 28f12c9f4f39d283d823d81e311d863526dfdb54
branch: main
author: Jason R. Coombs <jaraco at jaraco.com>
committer: jaraco <jaraco at jaraco.com>
date: 2021-05-27T19:36:06-04:00
summary:

bpo-44246: Update What's New for importlib.metadata. (#26408)

* bpo-44246: Update What's New for importlib.metadata.

Bump version of importlib_metadata included.
Add note about compatibility notice and fix link to entry_points documentation.
Add note about removal of access by index on Distribution.entry_points.

* Fix syntax mistake in issue reference.

Co-authored-by: Ken Jin <28750310+Fidget-Spinner at users.noreply.github.com>

* Fix broken reference in entry-points.

Co-authored-by: Ken Jin <28750310+Fidget-Spinner at users.noreply.github.com>

files:
M Doc/whatsnew/3.10.rst

diff --git a/Doc/whatsnew/3.10.rst b/Doc/whatsnew/3.10.rst
index 581db4f340cff..8b6637b447456 100644
--- a/Doc/whatsnew/3.10.rst
+++ b/Doc/whatsnew/3.10.rst
@@ -1039,11 +1039,17 @@ and will be incorrect in some rare cases, including some ``_``-s in
 importlib.metadata
 ------------------
 
-Feature parity with ``importlib_metadata`` 3.7.
+Feature parity with ``importlib_metadata`` 4.2
+(`history <https://importlib-metadata.readthedocs.io/en/latest/history.html>`_).
 
-:func:`importlib.metadata.entry_points` now provides a nicer experience
+:ref:`importlib.metadata entry points <entry-points>`
+now provides a nicer experience
 for selecting entry points by group and name through a new
-:class:`importlib.metadata.EntryPoints` class.
+:class:`importlib.metadata.EntryPoints` class. See the Compatibility
+Note in the docs for more info on the deprecation and usage.
+Incidentally, these changes also removed access by index on the
+result of :func:`importlib.metadata.Distribution.entry_points`
+(see :issue:`44246` for more detail).
 
 Added :func:`importlib.metadata.packages_distributions` for resolving
 top-level Python modules and packages to their