From beffd233d0c96545e18a432c27f8b32b1b68474d Mon Sep 17 00:00:00 2001 From: "C.A.M. Gerlach" Date: Mon, 24 Oct 2022 21:59:29 -0500 Subject: [PATCH 1/4] Add two line breaks and ref target labels to remaining subsections --- Doc/whatsnew/3.11.rst | 67 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 67 insertions(+) diff --git a/Doc/whatsnew/3.11.rst b/Doc/whatsnew/3.11.rst index deec420068504c..0f5b3a8faa6c62 100644 --- a/Doc/whatsnew/3.11.rst +++ b/Doc/whatsnew/3.11.rst @@ -614,6 +614,9 @@ asyncio These are primarily intended for internal use, notably by :class:`~asyncio.TaskGroup`. + +.. _whatsnew311-contextlib: + contextlib ---------- @@ -621,6 +624,9 @@ Added non parallel-safe :func:`~contextlib.chdir` context manager to change the current working directory and then restore it on exit. Simple wrapper around :func:`~os.chdir`. (Contributed by Filipe Laíns in :issue:`25625`) + +.. _whatsnew311-dataclasses: + dataclasses ----------- @@ -629,6 +635,9 @@ dataclasses :class:`dict`, :class:`list` or :class:`set`. (Contributed by Eric V. Smith in :issue:`44674`.) + +.. _whatsnew311-datetime: + datetime -------- @@ -708,6 +717,8 @@ enum inverted flags are coerced to their positive equivalent. +.. _whatsnew311-fractions: + fractions --------- @@ -718,6 +729,9 @@ fractions that an ``isinstance(some_fraction, typing.SupportsInt)`` check passes. (Contributed by Mark Dickinson in :issue:`44547`.) + +.. _whatsnew311-functools: + functools --------- @@ -748,6 +762,9 @@ functools (Contributed by Yurii Karabas in :issue:`46014`.) + +.. _whatsnew311-hashlib: + hashlib ------- @@ -766,6 +783,9 @@ hashlib of files or file-like objects. (Contributed by Christian Heimes in :gh:`89313`.) + +.. _whatsnew311-idle: + IDLE and idlelib ---------------- @@ -803,6 +823,9 @@ inspect (Contributed by Pablo Galindo in :gh:`88116`.) + +.. _whatsnew311-locale: + locale ------ @@ -830,6 +853,8 @@ logging (Contributed by Kirill Pinchuk in :gh:`88457`.) +.. _whatsnew311-math: + math ---- @@ -849,6 +874,8 @@ math (Contributed by Victor Stinner in :issue:`46917`.) +.. _whatsnew311-operator: + operator -------- @@ -857,6 +884,8 @@ operator (Contributed by Antony Lee in :issue:`44019`.) +.. _whatsnew311-os: + os -- @@ -865,6 +894,8 @@ os (Contributed by Dong-hee Na in :issue:`44611`.) +.. _whatsnew311-pathlib: + pathlib ------- @@ -873,6 +904,9 @@ pathlib :data:`~os.sep` or :data:`~os.altsep`. (Contributed by Eisuke Kawasima in :issue:`22276` and :issue:`33392`.) + +.. _whatsnew311-re: + re -- @@ -880,6 +914,9 @@ re ``?+``, ``{m,n}+``) are now supported in regular expressions. (Contributed by Jeffrey C. Jacobs and Serhiy Storchaka in :issue:`433030`.) + +.. _whatsnew311-shutil: + shutil ------ @@ -887,6 +924,8 @@ shutil (Contributed by Serhiy Storchaka in :issue:`46245`.) +.. _whatsnew311-socket: + socket ------ @@ -898,6 +937,9 @@ socket instead of only raising the last error. (Contributed by Irit Katriel in :issue:`29980`.) + +.. _whatsnew311-sqlite3: + sqlite3 ------- @@ -961,6 +1003,8 @@ string (Contributed by Ben Kehoe in :gh:`90465`.) +.. _whatsnew311-sys: + sys --- @@ -978,6 +1022,8 @@ sys (Contributed by Victor Stinner in :gh:`57684`.) +.. _whatsnew311-sysconfig: + sysconfig --------- @@ -1008,6 +1054,8 @@ tempfile (Contributed by Carey Metcalfe in :gh:`70363`.) +.. _whatsnew311-threading: + threading --------- @@ -1019,6 +1067,8 @@ threading (Contributed by Victor Stinner in :issue:`41710`.) +.. _whatsnew311-time: + time ---- @@ -1036,6 +1086,8 @@ time (Contributed by Benjamin Szőke, Dong-hee Na, Eryk Sun and Victor Stinner in :issue:`21302` and :issue:`45429`.) +.. _whatsnew311-traceback: + traceback --------- @@ -1049,6 +1101,8 @@ traceback (Contributed by Irit Katriel in :issue:`33809`.) +.. _whatsnew311-typing: + typing ------ @@ -1118,6 +1172,8 @@ For major changes, see :ref:`new-feat-related-type-hints-311`. by Nikita Sobolev in :gh:`90729`.) +.. _whatsnew311-tkinter: + tkinter ------- @@ -1126,12 +1182,16 @@ tkinter (Contributed by Serhiy Storchaka in :gh:`91827`.) +.. _whatsnew311-unicodedata: + unicodedata ----------- * The Unicode database has been updated to version 14.0.0. (Contributed by Benjamin Peterson in :issue:`45190`). +.. _whatsnew311-unittest: + unittest -------- @@ -1144,6 +1204,8 @@ unittest (Contributed by Serhiy Storchaka in :issue:`45046`.) +.. _whatsnew311-venv: + venv ---- @@ -1157,6 +1219,9 @@ venv Third party code that also creates new virtual environments should do the same. (Contributed by Miro Hrončok in :issue:`45413`.) + +.. _whatsnew311-warnings: + warnings -------- @@ -1183,6 +1248,8 @@ zipfile (Contributed by Miguel Brito in :gh:`88261`.) +.. _whatsnew311-fcntl: + fcntl ----- From 12321c933300d9639e1258cc2f1207da2a1ae0fb Mon Sep 17 00:00:00 2001 From: "C.A.M. Gerlach" Date: Mon, 24 Oct 2022 22:09:20 -0500 Subject: [PATCH 2/4] Fix a few out of order Improved Modules --- Doc/whatsnew/3.11.rst | 40 ++++++++++++++++++++-------------------- 1 file changed, 20 insertions(+), 20 deletions(-) diff --git a/Doc/whatsnew/3.11.rst b/Doc/whatsnew/3.11.rst index 0f5b3a8faa6c62..1e42bf1499208d 100644 --- a/Doc/whatsnew/3.11.rst +++ b/Doc/whatsnew/3.11.rst @@ -717,6 +717,16 @@ enum inverted flags are coerced to their positive equivalent. +.. _whatsnew311-fcntl: + +fcntl +----- + +* On FreeBSD, the :attr:`F_DUP2FD` and :attr:`F_DUP2FD_CLOEXEC` flags respectively + are supported, the former equals to ``dup2`` usage while the latter set + the ``FD_CLOEXEC`` flag in addition. + + .. _whatsnew311-fractions: fractions @@ -1086,6 +1096,16 @@ time (Contributed by Benjamin Szőke, Dong-hee Na, Eryk Sun and Victor Stinner in :issue:`21302` and :issue:`45429`.) +.. _whatsnew311-tkinter: + +tkinter +------- + +* Added method ``info_patchlevel()`` which returns the exact version of + the Tcl library as a named tuple similar to :data:`sys.version_info`. + (Contributed by Serhiy Storchaka in :gh:`91827`.) + + .. _whatsnew311-traceback: traceback @@ -1172,16 +1192,6 @@ For major changes, see :ref:`new-feat-related-type-hints-311`. by Nikita Sobolev in :gh:`90729`.) -.. _whatsnew311-tkinter: - -tkinter -------- - -* Added method ``info_patchlevel()`` which returns the exact version of - the Tcl library as a named tuple similar to :data:`sys.version_info`. - (Contributed by Serhiy Storchaka in :gh:`91827`.) - - .. _whatsnew311-unicodedata: unicodedata @@ -1248,16 +1258,6 @@ zipfile (Contributed by Miguel Brito in :gh:`88261`.) -.. _whatsnew311-fcntl: - -fcntl ------ - -* On FreeBSD, the :attr:`F_DUP2FD` and :attr:`F_DUP2FD_CLOEXEC` flags respectively - are supported, the former equals to ``dup2`` usage while the latter set - the ``FD_CLOEXEC`` flag in addition. - - .. _whatsnew311-optimizations: Optimizations From d2c059fff4d768fb6f33f0727b36af7faced8c90 Mon Sep 17 00:00:00 2001 From: "C.A.M. Gerlach" Date: Mon, 24 Oct 2022 22:11:20 -0500 Subject: [PATCH 3/4] Fix a few minor textual formatting issues in sections --- Doc/whatsnew/3.11.rst | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/Doc/whatsnew/3.11.rst b/Doc/whatsnew/3.11.rst index 1e42bf1499208d..9d0e13e825425f 100644 --- a/Doc/whatsnew/3.11.rst +++ b/Doc/whatsnew/3.11.rst @@ -620,9 +620,9 @@ asyncio contextlib ---------- -Added non parallel-safe :func:`~contextlib.chdir` context manager to change -the current working directory and then restore it on exit. Simple wrapper -around :func:`~os.chdir`. (Contributed by Filipe Laíns in :issue:`25625`) +* Added non parallel-safe :func:`~contextlib.chdir` context manager to change + the current working directory and then restore it on exit. Simple wrapper + around :func:`~os.chdir`. (Contributed by Filipe Laíns in :issue:`25625`) .. _whatsnew311-dataclasses: @@ -643,6 +643,7 @@ datetime * Add :attr:`datetime.UTC`, a convenience alias for :attr:`datetime.timezone.utc`. (Contributed by Kabir Kwatra in :gh:`91973`.) + * :meth:`datetime.date.fromisoformat`, :meth:`datetime.time.fromisoformat` and :meth:`datetime.datetime.fromisoformat` can now be used to parse most ISO 8601 formats (barring only those that support fractional hours and minutes). @@ -1197,7 +1198,8 @@ For major changes, see :ref:`new-feat-related-type-hints-311`. unicodedata ----------- -* The Unicode database has been updated to version 14.0.0. (Contributed by Benjamin Peterson in :issue:`45190`). +* The Unicode database has been updated to version 14.0.0. + (Contributed by Benjamin Peterson in :issue:`45190`). .. _whatsnew311-unittest: From 8d0e32e3af667cd316b4ffa50cec7fec392b6fdd Mon Sep 17 00:00:00 2001 From: "C.A.M. Gerlach" Date: Mon, 24 Oct 2022 22:25:11 -0500 Subject: [PATCH 4/4] Fix remaining Sphinx warnings in the Improved Modules section --- Doc/whatsnew/3.11.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/Doc/whatsnew/3.11.rst b/Doc/whatsnew/3.11.rst index 9d0e13e825425f..cc8437f1709a76 100644 --- a/Doc/whatsnew/3.11.rst +++ b/Doc/whatsnew/3.11.rst @@ -668,7 +668,7 @@ enum (used by :func:`str`, :func:`format` and :term:`f-string`\s). * Changed :class:`~enum.IntEnum`, :class:`~enum.IntFlag` and :class:`~enum.StrEnum` - to now inherit from :class:`ReprEnum`, + to now inherit from :class:`~enum.ReprEnum`, so their :func:`str` output now matches :func:`format` (both ``str(AnIntEnum.ONE)`` and ``format(AnIntEnum.ONE)`` return ``'1'``, whereas before ``str(AnIntEnum.ONE)`` returned ``'AnIntEnum.ONE'``. @@ -723,7 +723,7 @@ enum fcntl ----- -* On FreeBSD, the :attr:`F_DUP2FD` and :attr:`F_DUP2FD_CLOEXEC` flags respectively +* On FreeBSD, the :data:`!F_DUP2FD` and :data:`!F_DUP2FD_CLOEXEC` flags respectively are supported, the former equals to ``dup2`` usage while the latter set the ``FD_CLOEXEC`` flag in addition. @@ -1022,7 +1022,7 @@ sys * :func:`sys.exc_info` now derives the ``type`` and ``traceback`` fields from the ``value`` (the exception instance), so when an exception is modified while it is being handled, the changes are reflected in - the results of subsequent calls to :func:`exc_info`. + the results of subsequent calls to :func:`!exc_info`. (Contributed by Irit Katriel in :issue:`45711`.) * Add :func:`sys.exception` which returns the active exception instance @@ -1164,7 +1164,7 @@ For major changes, see :ref:`new-feat-related-type-hints-311`. to clear all registered overloads of a function. (Contributed by Jelle Zijlstra in :gh:`89263`.) -* The :meth:`__init__` method of :class:`~typing.Protocol` subclasses +* The :meth:`~object.__init__` method of :class:`~typing.Protocol` subclasses is now preserved. (Contributed by Adrian Garcia Badarasco in :gh:`88970`.) * The representation of empty tuple types (``Tuple[()]``) is simplified.