diff --git a/Doc/library/_thread.rst b/Doc/library/_thread.rst index 297f50a46e0692..c53ba8a97b3d08 100644 --- a/Doc/library/_thread.rst +++ b/Doc/library/_thread.rst @@ -182,9 +182,8 @@ Lock objects have the following methods: ``False`` if not. .. versionchanged:: 3.2 - The *timeout* parameter is new. + Added the *timeout* parameter. - .. versionchanged:: 3.2 Lock acquires can now be interrupted by signals on POSIX. diff --git a/Doc/library/collections.rst b/Doc/library/collections.rst index f868799e7f5c10..985d90874adec1 100644 --- a/Doc/library/collections.rst +++ b/Doc/library/collections.rst @@ -346,7 +346,6 @@ All of those tests treat missing elements as having zero counts so that .. versionchanged:: 3.10 Rich comparison operations were added. -.. versionchanged:: 3.10 In equality tests, missing elements are treated as having zero counts. Formerly, ``Counter(a=3)`` and ``Counter(a=3, b=0)`` were considered distinct. @@ -887,18 +886,14 @@ they add the ability to access fields by name instead of position index. Added support for *rename*. .. versionchanged:: 3.6 + Added the *module* parameter. The *verbose* and *rename* parameters became :ref:`keyword-only arguments `. - .. versionchanged:: 3.6 - Added the *module* parameter. - - .. versionchanged:: 3.7 - Removed the *verbose* parameter and the :attr:`_source` attribute. - .. versionchanged:: 3.7 Added the *defaults* parameter and the :attr:`_field_defaults` attribute. + Removed the *verbose* parameter and the :attr:`_source` attribute. .. doctest:: :options: +NORMALIZE_WHITESPACE diff --git a/Doc/library/compileall.rst b/Doc/library/compileall.rst index df1eefab839cc1..4130c29bacafff 100644 --- a/Doc/library/compileall.rst +++ b/Doc/library/compileall.rst @@ -212,10 +212,8 @@ Public functions .. versionchanged:: 3.5 Added the *workers* parameter. - .. versionchanged:: 3.5 *quiet* parameter was changed to a multilevel value. - .. versionchanged:: 3.5 The *legacy* parameter only writes out ``.pyc`` files, not ``.pyo`` files no matter what the value of *optimize* is. @@ -281,7 +279,6 @@ Public functions .. versionchanged:: 3.5 *quiet* parameter was changed to a multilevel value. - .. versionchanged:: 3.5 The *legacy* parameter only writes out ``.pyc`` files, not ``.pyo`` files no matter what the value of *optimize* is. @@ -310,7 +307,6 @@ Public functions .. versionchanged:: 3.5 *quiet* parameter was changed to a multilevel value. - .. versionchanged:: 3.5 The *legacy* parameter only writes out ``.pyc`` files, not ``.pyo`` files no matter what the value of *optimize* is. diff --git a/Doc/library/datetime.rst b/Doc/library/datetime.rst index 1905c9e1ca755d..05519016378a07 100644 --- a/Doc/library/datetime.rst +++ b/Doc/library/datetime.rst @@ -2611,7 +2611,6 @@ Notes: .. versionchanged:: 3.7 The UTC offset is not restricted to a whole number of minutes. - .. versionchanged:: 3.7 When the ``%z`` directive is provided to the :meth:`~.datetime.strptime` method, the UTC offsets can have a colon as a separator between hours, minutes and seconds. diff --git a/Doc/library/dis.rst b/Doc/library/dis.rst index 190e994a12cc71..5d308a120c4341 100644 --- a/Doc/library/dis.rst +++ b/Doc/library/dis.rst @@ -259,7 +259,6 @@ operation is being performed, so the intermediate analysis object isn't useful: .. versionchanged:: 3.7 Implemented recursive disassembling and added *depth* parameter. - .. versionchanged:: 3.7 This can now handle coroutine and asynchronous generator objects. .. versionchanged:: 3.11 @@ -1493,7 +1492,6 @@ iterations of the loop. .. versionchanged:: 3.13 The callable now always appears at the same position on the stack. - .. versionchanged:: 3.13 Calls with keyword arguments are now handled by :opcode:`CALL_KW`. diff --git a/Doc/library/fractions.rst b/Doc/library/fractions.rst index 887c3844d20faa..82450f334bcaa6 100644 --- a/Doc/library/fractions.rst +++ b/Doc/library/fractions.rst @@ -94,14 +94,12 @@ another rational number, or from a string. Underscores are now permitted when creating a :class:`Fraction` instance from a string, following :PEP:`515` rules. - .. versionchanged:: 3.11 :class:`Fraction` implements ``__int__`` now to satisfy ``typing.SupportsInt`` instance checks. .. versionchanged:: 3.12 Space is allowed around the slash for string inputs: ``Fraction('2 / 3')``. - .. versionchanged:: 3.12 :class:`Fraction` instances now support float-style formatting, with presentation types ``"e"``, ``"E"``, ``"f"``, ``"F"``, ``"g"``, ``"G"`` and ``"%""``. diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst index e598ef423de497..982de94465f9e6 100644 --- a/Doc/library/functions.rst +++ b/Doc/library/functions.rst @@ -950,7 +950,6 @@ are always available. They are listed here in alphabetical order. .. versionchanged:: 3.11 The delegation to :meth:`~object.__trunc__` is deprecated. - .. versionchanged:: 3.11 :class:`int` string inputs and string representations can be limited to help avoid denial of service attacks. A :exc:`ValueError` is raised when the limit is exceeded while converting a string *x* to an :class:`int` or @@ -1443,7 +1442,6 @@ are always available. They are listed here in alphabetical order. the second argument to be negative, permitting computation of modular inverses. - .. versionchanged:: 3.8 Allow keyword arguments. Formerly, only positional arguments were supported. diff --git a/Doc/library/hashlib.rst b/Doc/library/hashlib.rst index aa0c6fc503e8ff..7d710ed6f14e62 100644 --- a/Doc/library/hashlib.rst +++ b/Doc/library/hashlib.rst @@ -88,7 +88,6 @@ accessible by name via :func:`new`. See :data:`algorithms_available`. that the hashing algorithm is not used in a security context, e.g. as a non-cryptographic one-way compression function. -.. versionchanged:: 3.9 Hashlib now uses SHA3 and SHAKE from OpenSSL if it provides it. .. versionchanged:: 3.12 diff --git a/Doc/library/http.client.rst b/Doc/library/http.client.rst index 7e4502064f22a1..cc83c24854a0a4 100644 --- a/Doc/library/http.client.rst +++ b/Doc/library/http.client.rst @@ -81,7 +81,6 @@ The module provides the following classes: .. versionchanged:: 3.2 *source_address*, *context* and *check_hostname* were added. - .. versionchanged:: 3.2 This class now supports HTTPS virtual hosts if possible (that is, if :const:`ssl.HAS_SNI` is true). diff --git a/Doc/library/io.rst b/Doc/library/io.rst index 8eb531aa4ea248..574e0bab8afdf9 100644 --- a/Doc/library/io.rst +++ b/Doc/library/io.rst @@ -996,9 +996,8 @@ Text I/O object is immediately handled to its underlying binary *buffer*. .. versionchanged:: 3.3 - The *write_through* argument has been added. + The *write_through* parameter has been added. - .. versionchanged:: 3.3 The default *encoding* is now ``locale.getpreferredencoding(False)`` instead of ``locale.getpreferredencoding()``. Don't change temporary the locale encoding using :func:`locale.setlocale`, use the current locale diff --git a/Doc/library/json.rst b/Doc/library/json.rst index c82ff9dc325b4c..ac6934c8432ec1 100644 --- a/Doc/library/json.rst +++ b/Doc/library/json.rst @@ -288,7 +288,6 @@ Basic Usage .. versionchanged:: 3.6 All optional parameters are now :ref:`keyword-only `. - .. versionchanged:: 3.6 *fp* can now be a :term:`binary file`. The input encoding should be UTF-8, UTF-16 or UTF-32. diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst index e38b7435498507..331cdcfcadf5b1 100644 --- a/Doc/library/logging.rst +++ b/Doc/library/logging.rst @@ -1085,12 +1085,7 @@ information into logging calls. For a usage example, see the section on .. versionchanged:: 3.13 - Remove the undocumented :meth:`!warn`` method which was an alias to the - :meth:`!warning` method. - - .. versionchanged:: 3.13 - - The *merge_extra* argument was added. + The *merge_extra* parameter was added. Thread Safety diff --git a/Doc/library/os.rst b/Doc/library/os.rst index 09d8228f986e47..cba71f9ef2d9e6 100644 --- a/Doc/library/os.rst +++ b/Doc/library/os.rst @@ -3262,7 +3262,6 @@ features: .. versionchanged:: 3.8 Added the :attr:`st_reparse_tag` member on Windows. - .. versionchanged:: 3.8 On Windows, the :attr:`st_mode` member now identifies special files as :const:`S_IFCHR`, :const:`S_IFIFO` or :const:`S_IFBLK` as appropriate. diff --git a/Doc/library/pathlib.rst b/Doc/library/pathlib.rst index 4b461a5d4a2949..f62033ce575dd6 100644 --- a/Doc/library/pathlib.rst +++ b/Doc/library/pathlib.rst @@ -604,12 +604,10 @@ Pure paths provide the following methods and properties: >>> PurePath('/a/b/c.py').match('a/*.py') False - .. versionchanged:: 3.12 - The *pattern* parameter accepts a :term:`path-like object`. - .. versionchanged:: 3.12 The *case_sensitive* parameter was added. + The *pattern* parameter accepts a :term:`path-like object`. .. method:: PurePath.relative_to(other, walk_up=False) @@ -1030,7 +1028,6 @@ call fails (for example because the path doesn't exist). .. versionchanged:: 3.13 The *follow_symlinks* parameter was added. - .. versionchanged:: 3.13 The *pattern* parameter accepts a :term:`path-like object`. @@ -1050,7 +1047,6 @@ call fails (for example because the path doesn't exist). .. versionchanged:: 3.13 The *follow_symlinks* parameter was added. - .. versionchanged:: 3.13 The *pattern* parameter accepts a :term:`path-like object`. @@ -1062,13 +1058,11 @@ call fails (for example because the path doesn't exist). This method normally follows symlinks; to get the group of the symlink, add the argument ``follow_symlinks=False``. - .. versionchanged:: 3.13 - Raises :exc:`UnsupportedOperation` if the :mod:`grp` module is not - available. In previous versions, :exc:`NotImplementedError` was raised. - .. versionchanged:: 3.13 The *follow_symlinks* parameter was added. + Raises :exc:`UnsupportedOperation` if the :mod:`grp` module is not + available. In previous versions, :exc:`NotImplementedError` was raised. .. method:: Path.is_dir(*, follow_symlinks=True) @@ -1343,12 +1337,11 @@ call fails (for example because the path doesn't exist). the argument ``follow_symlinks=False``. .. versionchanged:: 3.13 + The *follow_symlinks* parameter was added. + Raises :exc:`UnsupportedOperation` if the :mod:`pwd` module is not available. In previous versions, :exc:`NotImplementedError` was raised. - .. versionchanged:: 3.13 - The *follow_symlinks* parameter was added. - .. method:: Path.read_bytes() diff --git a/Doc/library/pdb.rst b/Doc/library/pdb.rst index 1cfca0cf68a946..dee8097f02a251 100644 --- a/Doc/library/pdb.rst +++ b/Doc/library/pdb.rst @@ -587,7 +587,6 @@ can be overridden by the local file. ``exit()`` and ``quit()`` can be used to exit the :pdbcmd:`interact` command. - .. versionchanged:: 3.13 :pdbcmd:`interact` directs its output to the debugger's output channel rather than :data:`sys.stderr`. diff --git a/Doc/library/sched.rst b/Doc/library/sched.rst index 4c980dd97f9394..c9bb4775e24379 100644 --- a/Doc/library/sched.rst +++ b/Doc/library/sched.rst @@ -27,9 +27,8 @@ scheduler: applications. .. versionchanged:: 3.3 - *timefunc* and *delayfunc* parameters are optional. + The *timefunc* and *delayfunc* parameters are optional. - .. versionchanged:: 3.3 :class:`scheduler` class can be safely used in multi-threaded environments. @@ -84,11 +83,9 @@ Scheduler Objects (see :meth:`cancel`). .. versionchanged:: 3.3 - *argument* parameter is optional. - - .. versionchanged:: 3.3 - *kwargs* parameter was added. + The *kwargs* parameter was added. + The *argument* parameter is optional. .. method:: scheduler.enter(delay, priority, action, argument=(), kwargs={}) @@ -97,10 +94,9 @@ Scheduler Objects :meth:`enterabs`. .. versionchanged:: 3.3 - *argument* parameter is optional. + The *kwargs* parameter was added. - .. versionchanged:: 3.3 - *kwargs* parameter was added. + The *argument* parameter is optional. .. method:: scheduler.cancel(event) diff --git a/Doc/library/shutil.rst b/Doc/library/shutil.rst index 4f07b9f6040d24..187723e3818aac 100644 --- a/Doc/library/shutil.rst +++ b/Doc/library/shutil.rst @@ -285,13 +285,12 @@ Directory and files operations Now returns *dst*. .. versionchanged:: 3.8 + Added the *dirs_exist_ok* parameter. + Platform-specific fast-copy syscalls may be used internally in order to copy the file more efficiently. See :ref:`shutil-platform-dependent-efficient-copy-operations` section. - .. versionchanged:: 3.8 - Added the *dirs_exist_ok* parameter. - .. function:: rmtree(path, ignore_errors=False, onerror=None, *, onexc=None, dir_fd=None) .. index:: single: directory; deleting diff --git a/Doc/library/smtplib.rst b/Doc/library/smtplib.rst index aaec2aa1ef1dbe..031ed17b6b5722 100644 --- a/Doc/library/smtplib.rst +++ b/Doc/library/smtplib.rst @@ -63,10 +63,9 @@ Protocol) and :rfc:`1869` (SMTP Service Extensions). where ``data`` is the bytes about to be sent to the remote host. .. versionchanged:: 3.3 - Support for the :keyword:`with` statement was added. + The *source_address* parameter was added. - .. versionchanged:: 3.3 - *source_address* argument was added. + Support for the :keyword:`with` statement was added. .. versionadded:: 3.5 The SMTPUTF8 extension (:rfc:`6531`) is now supported. @@ -90,10 +89,7 @@ Protocol) and :rfc:`1869` (SMTP Service Extensions). best practices. .. versionchanged:: 3.3 - *context* was added. - - .. versionchanged:: 3.3 - The *source_address* argument was added. + The *context* and *source_address* parameters were added. .. versionchanged:: 3.4 The class now supports hostname check with diff --git a/Doc/library/socket.rst b/Doc/library/socket.rst index 3a931e25de91e5..b17b2e15730fe9 100644 --- a/Doc/library/socket.rst +++ b/Doc/library/socket.rst @@ -740,15 +740,13 @@ The following functions all create :ref:`socket objects `. The AF_RDS family was added. .. versionchanged:: 3.4 - The CAN_BCM protocol was added. + The CAN_BCM protocol was added. - .. versionchanged:: 3.4 The returned socket is now non-inheritable. .. versionchanged:: 3.7 - The CAN_ISOTP protocol was added. + The CAN_ISOTP protocol was added. - .. versionchanged:: 3.7 When :const:`SOCK_NONBLOCK` or :const:`SOCK_CLOEXEC` bit flags are applied to *type* they are cleared, and :attr:`socket.type` will not reflect them. They are still passed @@ -1802,7 +1800,6 @@ to sockets. The socket timeout is no longer reset each time data is sent successfully. The socket timeout is now the maximum total duration to send all data. - .. versionchanged:: 3.5 If the system call is interrupted and the signal handler does not raise an exception, the method now retries the system call instead of raising an :exc:`InterruptedError` exception (see :pep:`475` for the rationale). diff --git a/Doc/library/ssl.rst b/Doc/library/ssl.rst index 3564855594c32d..1de8fbe47ecacf 100644 --- a/Doc/library/ssl.rst +++ b/Doc/library/ssl.rst @@ -1080,7 +1080,6 @@ SSL Sockets .. versionchanged:: 3.5 The :meth:`sendfile` method was added. - .. versionchanged:: 3.5 The :meth:`shutdown` does not reset the socket timeout each time bytes are received or sent. The socket timeout is now the maximum total duration of the shutdown. @@ -1464,8 +1463,6 @@ to speed up repeated connections from the same clients. context class will either require :data:`PROTOCOL_TLS_CLIENT` or :data:`PROTOCOL_TLS_SERVER` protocol in the future. - .. versionchanged:: 3.10 - The default cipher suites now include only secure AES and ChaCha20 ciphers with forward secrecy and security level 2. RSA and DH keys with less than 2048 bits and ECC keys with less than 224 bits are prohibited. diff --git a/Doc/library/sys.rst b/Doc/library/sys.rst index 380ba1090b39b3..826d1ea0dc9996 100644 --- a/Doc/library/sys.rst +++ b/Doc/library/sys.rst @@ -609,8 +609,6 @@ always available. .. versionchanged:: 3.11 Added the ``safe_path`` attribute for :option:`-P` option. - - .. versionchanged:: 3.11 Added the ``int_max_str_digits`` attribute. diff --git a/Doc/library/threading.rst b/Doc/library/threading.rst index 4cf98a49e11442..f510415797ff9f 100644 --- a/Doc/library/threading.rst +++ b/Doc/library/threading.rst @@ -561,9 +561,8 @@ All methods are executed atomically. ``False`` if not (for example if the *timeout* expired). .. versionchanged:: 3.2 - The *timeout* parameter is new. + Added the *timeout* parameter. - .. versionchanged:: 3.2 Lock acquisition can now be interrupted by signals on POSIX if the underlying threading implementation supports it. @@ -645,7 +644,7 @@ Reentrant locks also support the :ref:`context management protocol ` been acquired, ``False`` if the timeout has elapsed. .. versionchanged:: 3.2 - The *timeout* parameter is new. + Added the *timeout* parameter. .. method:: release() @@ -892,7 +891,7 @@ Semaphores also support the :ref:`context management protocol `. that interval, return ``False``. Return ``True`` otherwise. .. versionchanged:: 3.2 - The *timeout* parameter is new. + Added the *timeout* parameter. .. method:: release(n=1) diff --git a/Doc/library/token.rst b/Doc/library/token.rst index e6dc37d7ad852c..42d935c06c808e 100644 --- a/Doc/library/token.rst +++ b/Doc/library/token.rst @@ -84,8 +84,6 @@ the :mod:`tokenize` module. .. versionchanged:: 3.7 Added :data:`COMMENT`, :data:`NL` and :data:`ENCODING` tokens. - -.. versionchanged:: 3.7 Removed :data:`!AWAIT` and :data:`!ASYNC` tokens. "async" and "await" are now tokenized as :data:`NAME` tokens. diff --git a/Doc/library/typing.rst b/Doc/library/typing.rst index da70757ea74452..592ff4336640d9 100644 --- a/Doc/library/typing.rst +++ b/Doc/library/typing.rst @@ -2244,7 +2244,6 @@ types. of that protocol on Python 3.12+, and vice versa. Most users are unlikely to be affected by this change. - .. versionchanged:: 3.12 The members of a runtime-checkable protocol are now considered "frozen" at runtime as soon as the class has been created. Monkey-patching attributes onto a runtime-checkable protocol will still work, but will @@ -2462,7 +2461,6 @@ types. Added support for marking individual keys as :data:`Required` or :data:`NotRequired`. See :pep:`655`. - .. versionchanged:: 3.11 Added support for generic ``TypedDict``\ s. .. versionchanged:: 3.13 diff --git a/Doc/library/unittest.mock.rst b/Doc/library/unittest.mock.rst index 1f25a16f544da8..4e4180d30ad2d6 100644 --- a/Doc/library/unittest.mock.rst +++ b/Doc/library/unittest.mock.rst @@ -2087,7 +2087,6 @@ The full list of supported magic methods is: .. versionchanged:: 3.8 Added support for :func:`os.PathLike.__fspath__`. -.. versionchanged:: 3.8 Added support for ``__aenter__``, ``__aexit__``, ``__aiter__`` and ``__anext__``. diff --git a/Doc/library/unittest.rst b/Doc/library/unittest.rst index e6140ac70eb87a..13e8304ab361ae 100644 --- a/Doc/library/unittest.rst +++ b/Doc/library/unittest.rst @@ -1913,10 +1913,8 @@ Loading and running tests Modules that raise :exc:`SkipTest` on import are recorded as skips, not errors. - .. versionchanged:: 3.4 *start_dir* can be a :term:`namespace packages `. - .. versionchanged:: 3.4 Paths are sorted before being imported so that execution order is the same even if the underlying file system's ordering is not dependent on file name. @@ -2228,7 +2226,6 @@ Loading and running tests .. versionchanged:: 3.2 Added the *warnings* parameter. - .. versionchanged:: 3.2 The default stream is set to :data:`sys.stderr` at instantiation time rather than import time. diff --git a/Doc/library/warnings.rst b/Doc/library/warnings.rst index 500398636e11ae..71eac239afadbc 100644 --- a/Doc/library/warnings.rst +++ b/Doc/library/warnings.rst @@ -243,7 +243,6 @@ In a :ref:`debug build `, the list of default warning filters is em :exc:`DeprecationWarning` is once again shown by default when triggered directly by code in ``__main__``. -.. versionchanged:: 3.7 :exc:`BytesWarning` no longer appears in the default filter list and is instead configured via :data:`sys.warnoptions` when :option:`-b` is specified twice. diff --git a/Doc/library/xml.etree.elementtree.rst b/Doc/library/xml.etree.elementtree.rst index 5955647588fa3e..907ea27281e0a5 100644 --- a/Doc/library/xml.etree.elementtree.rst +++ b/Doc/library/xml.etree.elementtree.rst @@ -721,7 +721,6 @@ Functions .. versionchanged:: 3.8 Added the *xml_declaration* and *default_namespace* parameters. - .. versionchanged:: 3.8 The :func:`tostring` function now preserves the attribute order specified by the user. @@ -748,7 +747,6 @@ Functions .. versionchanged:: 3.8 Added the *xml_declaration* and *default_namespace* parameters. - .. versionchanged:: 3.8 The :func:`tostringlist` function now preserves the attribute order specified by the user. diff --git a/Doc/library/zipfile.rst b/Doc/library/zipfile.rst index b6f881fd2dfd70..a264913d15f6b2 100644 --- a/Doc/library/zipfile.rst +++ b/Doc/library/zipfile.rst @@ -314,17 +314,13 @@ ZipFile Objects ZIP file that contains members with duplicate names. .. versionchanged:: 3.6 - Removed support of ``mode='U'``. Use :class:`io.TextIOWrapper` for reading - compressed text files in :term:`universal newlines` mode. - - .. versionchanged:: 3.6 - :meth:`ZipFile.open` can now be used to write files into the archive with the + :meth:`.open` can now be used to write files into the archive with the ``mode='w'`` option. - - .. versionchanged:: 3.6 Calling :meth:`.open` on a closed ZipFile will raise a :exc:`ValueError`. Previously, a :exc:`RuntimeError` was raised. + Removed support of ``mode='U'``. Use :class:`io.TextIOWrapper` for reading + compressed text files in :term:`universal newlines` mode. .. method:: ZipFile.extract(member, path=None, pwd=None) diff --git a/Doc/using/windows.rst b/Doc/using/windows.rst index cc4db34b04d900..37a715798d4961 100644 --- a/Doc/using/windows.rst +++ b/Doc/using/windows.rst @@ -1260,8 +1260,6 @@ non-standard paths in the registry and user site-packages. Add ``._pth`` file support and removes ``applocal`` option from ``pyvenv.cfg``. -.. versionchanged:: 3.6 - Add :file:`python{XX}.zip` as a potential landmark when directly adjacent to the executable.