# -*- coding: utf-8 -*-
-# Autogenerated by Sphinx on Tue Dec 3 19:41:14 2024
+# Autogenerated by Sphinx on Tue Feb 4 15:37:58 2025
# as part of the release process.
topics = {'assert': 'The "assert" statement\n'
'**********************\n'
' enter = type(manager).__enter__\n'
' exit = type(manager).__exit__\n'
' value = enter(manager)\n'
+ ' hit_except = False\n'
'\n'
' try:\n'
' TARGET = value\n'
' SUITE\n'
' except:\n'
+ ' hit_except = True\n'
' if not exit(manager, *sys.exc_info()):\n'
' raise\n'
- ' else:\n'
- ' exit(manager, None, None, None)\n'
+ ' finally:\n'
+ ' if not hit_except:\n'
+ ' exit(manager, None, None, None)\n'
'\n'
'With more than one item, the context managers are processed as '
'if\n'
'defparameter)* ["," [parameter_list_starargs]]\n'
' | parameter_list_starargs\n'
' parameter_list_starargs ::= "*" [star_parameter] ("," '
- 'defparameter)* ["," ["**" parameter [","]]]\n'
- ' | "**" parameter [","]\n'
+ 'defparameter)* ["," [parameter_star_kwargs]]\n'
+ ' "*" ("," defparameter)+ ["," '
+ '[parameter_star_kwargs]]\n'
+ ' | parameter_star_kwargs\n'
+ ' parameter_star_kwargs ::= "**" parameter [","]\n'
' parameter ::= identifier [":" expression]\n'
' star_parameter ::= identifier [":" ["*"] '
'expression]\n'
'trailing zeros are not removed from the result.\n'
'\n'
'The "\',\'" option signals the use of a comma for a '
- 'thousands separator.\n'
- 'For a locale aware separator, use the "\'n\'" integer '
+ 'thousands separator\n'
+ 'for floating-point presentation types and for integer '
+ 'presentation\n'
+ 'type "\'d\'". For other presentation types, this option is '
+ 'an error. For\n'
+ 'a locale aware separator, use the "\'n\'" integer '
'presentation type\n'
'instead.\n'
'\n'
'defparameter)* ["," [parameter_list_starargs]]\n'
' | parameter_list_starargs\n'
' parameter_list_starargs ::= "*" [star_parameter] ("," '
- 'defparameter)* ["," ["**" parameter [","]]]\n'
- ' | "**" parameter [","]\n'
+ 'defparameter)* ["," [parameter_star_kwargs]]\n'
+ ' "*" ("," defparameter)+ ["," '
+ '[parameter_star_kwargs]]\n'
+ ' | parameter_star_kwargs\n'
+ ' parameter_star_kwargs ::= "**" parameter [","]\n'
' parameter ::= identifier [":" expression]\n'
' star_parameter ::= identifier [":" ["*"] '
'expression]\n'
' enter = type(manager).__enter__\n'
' exit = type(manager).__exit__\n'
' value = enter(manager)\n'
+ ' hit_except = False\n'
'\n'
' try:\n'
' TARGET = value\n'
' SUITE\n'
' except:\n'
+ ' hit_except = True\n'
' if not exit(manager, *sys.exc_info()):\n'
' raise\n'
- ' else:\n'
- ' exit(manager, None, None, None)\n'
+ ' finally:\n'
+ ' if not hit_except:\n'
+ ' exit(manager, None, None, None)\n'
'\n'
'With more than one item, the context managers are processed as if\n'
'multiple "with" statements were nested:\n'
--- /dev/null
+.. date: 2024-12-13-13-41-34
+.. gh-issue: 127906
+.. nonce: NuRHlB
+.. release date: 2025-02-04
+.. section: Tests
+
+Test the limited C API in test_cppext. Patch by Victor Stinner.
+
+..
+
+.. date: 2024-12-13-13-16-43
+.. gh-issue: 127906
+.. nonce: wsZJ29
+.. section: Tests
+
+Backport test_cext from the main branch. Patch by Victor Stinner.
+
+..
+
+.. date: 2024-12-09-12-35-44
+.. gh-issue: 127637
+.. nonce: KLx-9I
+.. section: Tests
+
+Add tests for the :mod:`dis` command-line interface. Patch by Bénédikt Tran.
+
+..
+
+.. date: 2025-01-28-14-08-03
+.. gh-issue: 105704
+.. nonce: EnhHxu
+.. section: Security
+
+When using :func:`urllib.parse.urlsplit` and :func:`urllib.parse.urlparse`
+host parsing would not reject domain names containing square brackets (``[``
+and ``]``). Square brackets are only valid for IPv6 and IPvFuture hosts
+according to `RFC 3986 Section 3.2.2
+<https://www.rfc-editor.org/rfc/rfc3986#section-3.2.2>`__.
+
+..
+
+.. date: 2024-12-05-21-35-19
+.. gh-issue: 127655
+.. nonce: xpPoOf
+.. section: Security
+
+Fixed the :class:`!asyncio.selector_events._SelectorSocketTransport`
+transport not pausing writes for the protocol when the buffer reaches the
+high water mark when using :meth:`asyncio.WriteTransport.writelines`.
+
+..
+
+.. date: 2024-10-29-09-15-10
+.. gh-issue: 126108
+.. nonce: eTIjHY
+.. section: Security
+
+Fix a possible ``NULL`` pointer dereference in
+:c:func:`!PySys_AddWarnOptionUnicode`.
+
+..
+
+.. date: 2024-08-06-11-43-08
+.. gh-issue: 80222
+.. nonce: wfR4BU
+.. section: Security
+
+Fix bug in the folding of quoted strings when flattening an email message
+using a modern email policy. Previously when a quoted string was folded so
+that it spanned more than one line, the surrounding quotes and internal
+escapes would be omitted. This could theoretically be used to spoof header
+lines using a carefully constructed quoted string if the resulting rendered
+email was transmitted or re-parsed.
+
+..
+
+.. date: 2024-05-24-21-00-52
+.. gh-issue: 119511
+.. nonce: jKrXQ8
+.. section: Security
+
+Fix a potential denial of service in the :mod:`imaplib` module. When
+connecting to a malicious server, it could cause an arbitrary amount of
+memory to be allocated. On many systems this is harmless as unused virtual
+memory is only a mapping, but if this hit a virtual address size limit it
+could lead to a :exc:`MemoryError` or other process crash. On unusual
+systems or builds where all allocated memory is touched and backed by actual
+ram or storage it could've consumed resources doing so until similarly
+crashing.
+
+..
+
+.. date: 2025-01-31-11-14-05
+.. gh-issue: 129502
+.. nonce: j_ArNo
+.. section: Library
+
+Unlikely errors in preparing arguments for :mod:`ctypes` callback are now
+handled in the same way as errors raised in the callback of in converting
+the result of the callback -- using :func:`sys.unraisablehook` instead of
+:func:`sys.excepthook` and not setting :data:`sys.last_exc` and other
+variables.
+
+..
+
+.. date: 2025-01-29-17-10-00
+.. gh-issue: 129403
+.. nonce: 314159
+.. section: Library
+
+Corrected :exc:`ValueError` message for :class:`asyncio.Barrier` and
+:class:`threading.Barrier`.
+
+..
+
+.. date: 2025-01-29-14-30-54
+.. gh-issue: 129409
+.. nonce: JZbOE6
+.. section: Library
+
+Fix an integer overflow in the :mod:`csv` module when writing a data field
+larger than 2GB.
+
+..
+
+.. date: 2025-01-29-10-53-32
+.. gh-issue: 118761
+.. nonce: i8wjpV
+.. section: Library
+
+Improve import time of :mod:`subprocess` by lazy importing ``locale`` and
+``signal``. Patch by Taneli Hukkinen.
+
+..
+
+.. date: 2025-01-27-14-05-19
+.. gh-issue: 129346
+.. nonce: gZRd3g
+.. section: Library
+
+In :mod:`sqlite3`, handle out-of-memory when creating user-defined SQL
+functions.
+
+..
+
+.. date: 2025-01-20-13-12-39
+.. gh-issue: 128550
+.. nonce: AJ5TOL
+.. section: Library
+
+Removed an incorrect optimization relating to eager tasks in
+:class:`asyncio.TaskGroup` that resulted in cancellations being missed.
+
+..
+
+.. date: 2025-01-18-16-58-10
+.. gh-issue: 128991
+.. nonce: EzJit9
+.. section: Library
+
+Release the enter frame reference within :mod:`bdb` callback
+
+..
+
+.. date: 2025-01-17-21-33-11
+.. gh-issue: 128961
+.. nonce: XwvyIZ
+.. section: Library
+
+Fix a crash when setting state on an exhausted :class:`array.array`
+iterator.
+
+..
+
+.. date: 2025-01-17-11-46-16
+.. gh-issue: 128916
+.. nonce: GEePbO
+.. section: Library
+
+Do not attempt to set ``SO_REUSEPORT`` on sockets of address families other
+than ``AF_INET`` and ``AF_INET6``, as it is meaningless with these address
+families, and the call with fail with Linux kernel 6.12.9 and newer.
+
+..
+
+.. date: 2025-01-10-15-43-52
+.. gh-issue: 128679
+.. nonce: KcfVVR
+.. section: Library
+
+Fix :func:`tracemalloc.stop` race condition. Fix :mod:`tracemalloc` to
+support calling :func:`tracemalloc.stop` in one thread, while another thread
+is tracing memory allocations. Patch by Victor Stinner.
+
+..
+
+.. date: 2025-01-08-03-09-29
+.. gh-issue: 128562
+.. nonce: Mlv-yO
+.. section: Library
+
+Fix possible conflicts in generated :mod:`tkinter` widget names if the
+widget class name ends with a digit.
+
+..
+
+.. date: 2025-01-06-18-41-08
+.. gh-issue: 128552
+.. nonce: fV-f8j
+.. section: Library
+
+Fix cyclic garbage introduced by :meth:`asyncio.loop.create_task` and
+:meth:`asyncio.TaskGroup.create_task` holding a reference to the created
+task if it is eager.
+
+..
+
+.. date: 2025-01-04-11-10-04
+.. gh-issue: 128479
+.. nonce: jvOrF-
+.. section: Library
+
+Fix :func:`!asyncio.staggered.staggered_race` leaking tasks and issuing an
+unhandled exception.
+
+..
+
+.. date: 2024-12-30-20-48-28
+.. gh-issue: 88834
+.. nonce: RIvgwc
+.. section: Library
+
+Unify the instance check for :class:`typing.Union` and
+:class:`types.UnionType`: :class:`!Union` now uses the instance checks
+against its parameters instead of the subclass checks.
+
+..
+
+.. date: 2024-12-29-13-49-46
+.. gh-issue: 128302
+.. nonce: psRpPN
+.. section: Library
+
+Fix :meth:`!xml.dom.xmlbuilder.DOMEntityResolver.resolveEntity`, which was
+broken by the Python 3.0 transition.
+
+..
+
+.. date: 2024-12-27-16-28-57
+.. gh-issue: 128302
+.. nonce: 2GMvyl
+.. section: Library
+
+Allow :meth:`!xml.dom.xmlbuilder.DOMParser.parse` to correctly handle
+:class:`!xml.dom.xmlbuilder.DOMInputSource` instances that only have a
+:attr:`!systemId` attribute set.
+
+..
+
+.. date: 2024-12-26-11-00-03
+.. gh-issue: 112064
+.. nonce: mCcw3B
+.. section: Library
+
+Fix incorrect handling of negative read sizes in :meth:`HTTPResponse.read
+<http.client.HTTPResponse.read>`. Patch by Yury Manushkin.
+
+..
+
+.. date: 2024-12-23-02-09-44
+.. gh-issue: 58956
+.. nonce: 4OdMdT
+.. section: Library
+
+Fixed a frame reference leak in :mod:`bdb`.
+
+..
+
+.. date: 2024-12-21-03-20-12
+.. gh-issue: 128131
+.. nonce: QpPmNt
+.. section: Library
+
+Completely support random access of uncompressed unencrypted read-only zip
+files obtained by :meth:`ZipFile.open <zipfile.ZipFile.open>`.
+
+..
+
+.. date: 2024-12-20-08-44-12
+.. gh-issue: 127975
+.. nonce: 8HJwu9
+.. section: Library
+
+Avoid reusing quote types in :func:`ast.unparse` if not needed.
+
+..
+
+.. date: 2024-12-18-00-07-50
+.. gh-issue: 128014
+.. nonce: F3aUbz
+.. section: Library
+
+Fix resetting the default window icon by passing ``default=''`` to the
+:mod:`tkinter` method :meth:`!wm_iconbitmap`.
+
+..
+
+.. date: 2024-12-17-16-48-02
+.. gh-issue: 115514
+.. nonce: 1yOJ7T
+.. section: Library
+
+Fix exceptions and incomplete writes after
+:class:`!asyncio._SelectorTransport` is closed before writes are completed.
+
+..
+
+.. date: 2024-12-17-15-23-40
+.. gh-issue: 41872
+.. nonce: 31LjKY
+.. section: Library
+
+Fix quick extraction of module docstrings from a file in :mod:`pydoc`. It
+now supports docstrings with single quotes, escape sequences, raw string
+literals, and other Python syntax.
+
+..
+
+.. date: 2024-12-17-12-41-07
+.. gh-issue: 126742
+.. nonce: l07qvT
+.. section: Library
+
+Fix support of localized error messages reported by :manpage:`dlerror(3)`
+and :manpage:`gdbm_strerror <gdbm(3)>` in :mod:`ctypes` and :mod:`dbm.gnu`
+functions respectively. Patch by Bénédikt Tran.
+
+..
+
+.. date: 2024-12-12-16-59-42
+.. gh-issue: 127870
+.. nonce: _NFG-3
+.. section: Library
+
+Detect recursive calls in ctypes ``_as_parameter_`` handling. Patch by
+Victor Stinner.
+
+..
+
+.. date: 2024-12-12-07-27-51
+.. gh-issue: 127847
+.. nonce: ksfNKM
+.. section: Library
+
+Fix the position when doing interleaved seeks and reads in uncompressed,
+unencrypted zip files returned by :meth:`zipfile.ZipFile.open`.
+
+..
+
+.. date: 2024-12-08-08-36-18
+.. gh-issue: 127732
+.. nonce: UEKxoa
+.. section: Library
+
+The :mod:`platform` module now correctly detects Windows Server 2025.
+
+..
+
+.. date: 2024-12-04-11-01-16
+.. gh-issue: 93312
+.. nonce: 9sB-Qw
+.. section: Library
+
+Include ``<sys/pidfd.h>`` to get ``os.PIDFD_NONBLOCK`` constant. Patch by
+Victor Stinner.
+
+..
+
+.. date: 2024-12-04-10-39-29
+.. gh-issue: 83662
+.. nonce: CG1s3m
+.. section: Library
+
+Add missing ``__class_getitem__`` method to the Python implementation of
+:func:`functools.partial`, to make it compatible with the C version. This is
+mainly relevant for alternative Python implementations like PyPy and
+GraalPy, because CPython will usually use the C-implementation of that
+function.
+
+..
+
+.. date: 2024-12-03-20-28-08
+.. gh-issue: 127586
+.. nonce: zgotYF
+.. section: Library
+
+:class:`multiprocessing.pool.Pool` now properly restores blocked signal
+handlers of the parent thread when creating processes via either *spawn* or
+*forkserver*.
+
+..
+
+.. date: 2024-12-03-14-45-16
+.. gh-issue: 98188
+.. nonce: GX9i2b
+.. section: Library
+
+Fix an issue in :meth:`email.message.Message.get_payload` where data cannot
+be decoded if the Content Transfer Encoding mechanism contains trailing
+whitespaces or additional junk text. Patch by Hui Liu.
+
+..
+
+.. date: 2024-11-28-14-14-46
+.. gh-issue: 127257
+.. nonce: n6-jU9
+.. section: Library
+
+In :mod:`ssl`, system call failures that OpenSSL reports using
+``ERR_LIB_SYS`` are now raised as :exc:`OSError`.
+
+..
+
+.. date: 2024-11-13-10-44-25
+.. gh-issue: 126775
+.. nonce: a3ubjh
+.. section: Library
+
+Make :func:`linecache.checkcache` thread safe and GC re-entrancy safe.
+
+..
+
+.. date: 2024-09-24-18-16-59
+.. gh-issue: 58956
+.. nonce: 0wFrBR
+.. section: Library
+
+Fixed a bug in :mod:`pdb` where sometimes the breakpoint won't trigger if it
+was set on a function which is already in the call stack.
+
+..
+
+.. date: 2024-08-27-18-58-01
+.. gh-issue: 123401
+.. nonce: t4-FpI
+.. section: Library
+
+The :mod:`http.cookies` module now supports parsing obsolete :rfc:`850` date
+formats, in accordance with :rfc:`9110` requirements. Patch by Nano Zheng.
+
+..
+
+.. date: 2024-08-17-08-17-20
+.. gh-issue: 123085
+.. nonce: 7Io2yH
+.. section: Library
+
+In a bare call to :func:`importlib.resources.files`, ensure the caller's
+frame is properly detected when ``importlib.resources`` is itself available
+as a compiled module only (no source).
+
+..
+
+.. date: 2024-07-30-11-37-40
+.. gh-issue: 122431
+.. nonce: lAzVtu
+.. section: Library
+
+:func:`readline.append_history_file` now raises a :exc:`ValueError` when
+given a negative value.
+
+..
+
+.. date: 2025-01-16-18-59-11
+.. gh-issue: 125722
+.. nonce: eHHRga
+.. section: Documentation
+
+Require Sphinx 8.1.3 or later to build the Python documentation. Patch by
+Adam Turner.
+
+..
+
+.. date: 2025-01-14-11-06-41
+.. gh-issue: 67206
+.. nonce: LYKmi5
+.. section: Documentation
+
+Document that :const:`string.printable` is not printable in the POSIX sense.
+In particular, :meth:`string.printable.isprintable() <str.isprintable>`
+returns :const:`False`. Patch by Bénédikt Tran.
+
+..
+
+.. date: 2025-01-28-06-23-59
+.. gh-issue: 129345
+.. nonce: uOjkML
+.. section: Core and Builtins
+
+Fix null pointer dereference in :func:`syslog.openlog` when an audit hook
+raises an exception.
+
+..
+
+.. date: 2025-01-21-23-35-41
+.. gh-issue: 129093
+.. nonce: 0rvETC
+.. section: Core and Builtins
+
+Fix f-strings such as ``f'{expr=}'`` sometimes not displaying the full
+expression when the expression contains ``!=``.
+
+..
+
+.. date: 2025-01-21-19-48-30
+.. gh-issue: 124363
+.. nonce: vOFhHW
+.. section: Core and Builtins
+
+Treat debug expressions in f-string as raw strings. Patch by Pablo Galindo
+
+..
+
+.. date: 2025-01-18-01-06-58
+.. gh-issue: 128799
+.. nonce: vSNagk
+.. section: Core and Builtins
+
+Add frame of ``except*`` to traceback when it wraps a naked exception.
+
+..
+
+.. date: 2025-01-13-12-48-30
+.. gh-issue: 128078
+.. nonce: qOsl9B
+.. section: Core and Builtins
+
+Fix a :exc:`SystemError` when using :func:`anext` with a default tuple
+value. Patch by Bénédikt Tran.
+
+..
+
+.. date: 2024-12-18-14-22-48
+.. gh-issue: 128079
+.. nonce: SUD5le
+.. section: Core and Builtins
+
+Fix a bug where :keyword:`except* <except_star>` does not properly check the
+return value of an :exc:`ExceptionGroup`'s :meth:`~BaseExceptionGroup.split`
+function, leading to a crash in some cases. Now when
+:meth:`~BaseExceptionGroup.split` returns an invalid object,
+:keyword:`except* <except_star>` raises a :exc:`TypeError` with the original
+raised :exc:`ExceptionGroup` object chained to it.
+
+..
+
+.. date: 2024-12-13-14-17-24
+.. gh-issue: 127903
+.. nonce: vemHSl
+.. section: Core and Builtins
+
+``Objects/unicodeobject.c``: fix a crash on DEBUG builds in
+``_copy_characters`` when there is nothing to copy.
+
+..
+
+.. date: 2024-12-07-13-06-09
+.. gh-issue: 127599
+.. nonce: tXCZb_
+.. section: Core and Builtins
+
+Fix statistics for increments of object reference counts (in particular,
+when a reference count was increased by more than 1 in a single operation).
+
+..
+
+.. date: 2024-12-03-12-17-36
+.. gh-issue: 111609
+.. nonce: UHpQY9
+.. section: Core and Builtins
+
+Respect *end_offset* in :exc:`SyntaxError` subclasses.
+
+..
+
+.. date: 2024-12-02-18-15-37
+.. gh-issue: 126862
+.. nonce: fdIK7T
+.. section: Core and Builtins
+
+Fix a possible overflow when a class inherits from an absurd number of
+super-classes. Reported by Valery Fedorenko. Patch by Bénédikt Tran.
+
+..
+
+.. date: 2024-03-25-15-07-01
+.. gh-issue: 117195
+.. nonce: OWakgD
+.. section: Core and Builtins
+
+Avoid assertion failure for debug builds when calling
+``object.__sizeof__(1)``
+
+..
+
+.. date: 2024-11-07-20-24-58
+.. gh-issue: 126554
+.. nonce: ri12eb
+.. section: C API
+
+Fix error handling in :class:`ctypes.CDLL` objects which could result in a
+crash in rare situations.
+
+..
+
+.. date: 2023-07-25-17-23-08
+.. gh-issue: 107249
+.. nonce: xqk2ke
+.. section: C API
+
+Implement the :c:macro:`Py_UNUSED` macro for Windows MSVC compiler. Patch by
+Victor Stinner.
+
+..
+
+.. date: 2025-02-02-09-11-45
+.. gh-issue: 129539
+.. nonce: SYXXCg
+.. section: Build
+
+Don't redefine ``EX_OK`` when the system has the ``sysexits.h`` header.
+
+..
+
+.. date: 2025-01-04-22-39-10
+.. gh-issue: 128472
+.. nonce: Wt5E6M
+.. section: Build
+
+Skip BOLT optimization of functions using computed gotos, fixing errors on
+build with LLVM 19.
+
+..
+
+.. date: 2025-01-02-11-02-45
+.. gh-issue: 123925
+.. nonce: TLlyUi
+.. section: Build
+
+Fix building the :mod:`curses` module on platforms with libncurses but
+without libncursesw.
+
+..
+
+.. date: 2024-12-28-21-05-19
+.. gh-issue: 128321
+.. nonce: 0UvbXw
+.. section: Build
+
+Set ``LIBS`` instead of ``LDFLAGS`` when checking if :mod:`sqlite3` library
+functions are available. This fixes the ordering of linked libraries during
+checks, which was incorrect when using a statically linked ``libsqlite3``.