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 f40c6cea83820c..20b38865b5c884 100644 --- a/Doc/library/datetime.rst +++ b/Doc/library/datetime.rst @@ -2629,7 +2629,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 21ac2c87a1859e..48746e4c0e2724 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 0c7ef67774cd05..c7cb838595af1a 100644 --- a/Doc/library/functions.rst +++ b/Doc/library/functions.rst @@ -957,7 +957,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 @@ -1480,7 +1479,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 a733b288ecb6d0..59fe568f01c355 100644 --- a/Doc/library/logging.rst +++ b/Doc/library/logging.rst @@ -1126,12 +1126,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 6c92eed9c063f1..7ea5050443375b 100644 --- a/Doc/library/os.rst +++ b/Doc/library/os.rst @@ -3273,7 +3273,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 2e18e41869376e..f832e24341e257 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) @@ -1021,7 +1019,6 @@ call fails (for example because the path doesn't exist). .. versionchanged:: 3.13 The *recurse_symlinks* parameter was added. - .. versionchanged:: 3.13 The *pattern* parameter accepts a :term:`path-like object`. .. versionchanged:: 3.13 @@ -1046,7 +1043,6 @@ call fails (for example because the path doesn't exist). .. versionchanged:: 3.13 The *recurse_symlinks* parameter was added. - .. versionchanged:: 3.13 The *pattern* parameter accepts a :term:`path-like object`. @@ -1058,13 +1054,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) @@ -1339,12 +1333,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 7a47a7d5d6754f..e4d82500f43c4e 100644 --- a/Doc/library/pdb.rst +++ b/Doc/library/pdb.rst @@ -598,7 +598,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 331acfce3afee3..2729ba675107b1 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 76af783c6292f9..ea4a689e8656ea 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 a90436286ca819..80506d637666da 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 91afa9d58e87e6..74fe072524e47f 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 e06287250641e6..30e1166cffa836 100644 --- a/Doc/library/typing.rst +++ b/Doc/library/typing.rst @@ -2336,8 +2336,7 @@ 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" + Separately, 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 have no impact on :func:`isinstance` checks comparing objects to the @@ -2570,7 +2569,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 ee4c7b2ed252b0..b25c1303c2c378 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 3af29f19c802c7..f348a4408edaa8 100644 --- a/Doc/library/unittest.rst +++ b/Doc/library/unittest.rst @@ -1915,10 +1915,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. @@ -2233,7 +2231,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 30a7b653f940e9..273ae4d499c813 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 6192689c3a1194..f99334b6c018d2 100644 --- a/Doc/library/zipfile.rst +++ b/Doc/library/zipfile.rst @@ -318,17 +318,14 @@ 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. + .. versionchanged:: 3.13 Added attributes :attr:`!name` and :attr:`!mode` for the writeable file-like object. diff --git a/Doc/using/windows.rst b/Doc/using/windows.rst index ef98d32e8674ec..621a2617c38e6c 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.