diff options
Diffstat (limited to 'Doc')
31 files changed, 63 insertions, 63 deletions
diff --git a/Doc/c-api/arg.rst b/Doc/c-api/arg.rst index 0b05e86..3bbc990 100644 --- a/Doc/c-api/arg.rst +++ b/Doc/c-api/arg.rst @@ -274,7 +274,7 @@ small to receive the value. Convert a Python integer to a C :c:expr:`unsigned long` without overflow checking. - .. versionchanged:: next + .. versionchanged:: 3.14 Use :meth:`~object.__index__` if available. ``L`` (:class:`int`) [long long] @@ -284,7 +284,7 @@ small to receive the value. Convert a Python integer to a C :c:expr:`unsigned long long` without overflow checking. - .. versionchanged:: next + .. versionchanged:: 3.14 Use :meth:`~object.__index__` if available. ``n`` (:class:`int`) [:c:type:`Py_ssize_t`] @@ -380,10 +380,10 @@ Other objects The *converter* for the ``O&`` format unit in *items* must not store a borrowed buffer or a borrowed reference. - .. versionchanged:: next + .. versionchanged:: 3.14 :class:`str` and :class:`bytearray` objects no longer accepted as a sequence. - .. deprecated:: next + .. deprecated:: 3.14 Non-tuple sequences are deprecated if *items* contains format units which store a borrowed buffer or a borrowed reference. @@ -396,7 +396,7 @@ Other objects If the argument is not ``None``, it is parsed according to the specified format unit. - .. versionadded:: next + .. versionadded:: 3.14 A few other characters have a meaning in a format string. These may not occur inside nested parentheses. They are: diff --git a/Doc/c-api/init_config.rst b/Doc/c-api/init_config.rst index 1f413a8..e193165 100644 --- a/Doc/c-api/init_config.rst +++ b/Doc/c-api/init_config.rst @@ -1486,7 +1486,7 @@ PyConfig Default: ``0``. - .. versionchanged:: next + .. versionchanged:: 3.14 Added support for ``import_time = 2`` diff --git a/Doc/howto/logging-cookbook.rst b/Doc/howto/logging-cookbook.rst index 661d6c2..7d64a02 100644 --- a/Doc/howto/logging-cookbook.rst +++ b/Doc/howto/logging-cookbook.rst @@ -626,7 +626,7 @@ which, when run, will produce: of each message with the handler's level, and only passes a message to a handler if it's appropriate to do so. -.. versionchanged:: next +.. versionchanged:: 3.14 The :class:`QueueListener` can be started (and stopped) via the :keyword:`with` statement. For example: diff --git a/Doc/library/argparse.rst b/Doc/library/argparse.rst index feccc63..29396c7 100644 --- a/Doc/library/argparse.rst +++ b/Doc/library/argparse.rst @@ -641,7 +641,7 @@ keyword argument:: >>> parser = argparse.ArgumentParser(description='Process some integers.') >>> parser.color = True -.. versionadded:: next +.. versionadded:: 3.14 The add_argument() method diff --git a/Doc/library/ast.rst b/Doc/library/ast.rst index c9ae0ab..ca9a6b0 100644 --- a/Doc/library/ast.rst +++ b/Doc/library/ast.rst @@ -2577,21 +2577,21 @@ The following options are accepted: Python version in the format 3.x (for example, 3.10). Defaults to the current version of the interpreter. - .. versionadded:: next + .. versionadded:: 3.14 .. option:: -O <level> --optimize <level> Optimization level for parser. Defaults to no optimization. - .. versionadded:: next + .. versionadded:: 3.14 .. option:: --show-empty Show empty lists and fields that are ``None``. Defaults to not showing empty objects. - .. versionadded:: next + .. versionadded:: 3.14 If :file:`infile` is specified its contents are parsed to AST and dumped diff --git a/Doc/library/asyncio-eventloop.rst b/Doc/library/asyncio-eventloop.rst index e25f6e5..21f7d05 100644 --- a/Doc/library/asyncio-eventloop.rst +++ b/Doc/library/asyncio-eventloop.rst @@ -388,7 +388,7 @@ Creating Futures and Tasks .. versionchanged:: 3.11 Added the *context* parameter. - .. versionchanged:: next + .. versionchanged:: 3.14 Added the *eager_start* parameter. .. method:: loop.set_task_factory(factory) diff --git a/Doc/library/audit_events.rst b/Doc/library/audit_events.rst index d2377a3..73a5809 100644 --- a/Doc/library/audit_events.rst +++ b/Doc/library/audit_events.rst @@ -48,5 +48,5 @@ public API of CPython: | ctypes.PyObj_FromPtr | ``obj`` | +----------------------------+-------------------------------------------+ -.. versionadded:: next +.. versionadded:: 3.14 The ``_posixsubprocess.fork_exec`` internal audit event. diff --git a/Doc/library/codecs.rst b/Doc/library/codecs.rst index 14f6547..8651160 100644 --- a/Doc/library/codecs.rst +++ b/Doc/library/codecs.rst @@ -208,7 +208,7 @@ wider range of codecs when working with binary files: .. versionchanged:: 3.11 The ``'U'`` mode has been removed. - .. deprecated:: next + .. deprecated:: 3.14 :func:`codecs.open` has been superseded by :func:`open`. diff --git a/Doc/library/ctypes.rst b/Doc/library/ctypes.rst index 1b78b33..5b733d5 100644 --- a/Doc/library/ctypes.rst +++ b/Doc/library/ctypes.rst @@ -2358,7 +2358,7 @@ Data types :func:`POINTER` for corresponding ctypes data type. If a pointer type was not yet created, the attribute is missing. - .. versionadded:: next + .. versionadded:: 3.14 Common instance variables of ctypes data types: @@ -2756,7 +2756,7 @@ fields, or any other data types containing pointer type fields. This is only implemented for the MSVC-compatible memory layout. - .. deprecated-removed:: next 3.19 + .. deprecated-removed:: 3.14 3.19 For historical reasons, if :attr:`!_pack_` is non-zero, the MSVC-compatible layout will be used by default. @@ -2799,7 +2799,7 @@ fields, or any other data types containing pointer type fields. :attr:`!_layout_` must already be defined when :attr:`~Structure._fields_` is assigned, otherwise it will have no effect. - .. versionadded:: next + .. versionadded:: 3.14 .. attribute:: _anonymous_ diff --git a/Doc/library/curses.rst b/Doc/library/curses.rst index 4bccfdd..137504c 100644 --- a/Doc/library/curses.rst +++ b/Doc/library/curses.rst @@ -80,7 +80,7 @@ The module :mod:`curses` defines the following functions: * Change the definition of the color-pair ``0`` to ``(fg, bg)``. - .. versionadded:: next + .. versionadded:: 3.14 .. function:: baudrate() diff --git a/Doc/library/decimal.rst b/Doc/library/decimal.rst index deaad05..f53c1f3 100644 --- a/Doc/library/decimal.rst +++ b/Doc/library/decimal.rst @@ -1037,7 +1037,7 @@ function to temporarily change the active context. IEEE interchange formats. The argument must be a multiple of 32 and less than :const:`IEEE_CONTEXT_MAX_BITS`. - .. versionadded:: next + .. versionadded:: 3.14 New contexts can also be created using the :class:`Context` constructor described below. In addition, the module provides three pre-made contexts: diff --git a/Doc/library/exceptions.rst b/Doc/library/exceptions.rst index 4b391ba..bb72032 100644 --- a/Doc/library/exceptions.rst +++ b/Doc/library/exceptions.rst @@ -436,7 +436,7 @@ The following exceptions are the exceptions that are usually raised. .. versionadded:: 3.13 Previously, a plain :exc:`RuntimeError` was raised. - .. versionchanged:: next + .. versionchanged:: 3.14 :meth:`threading.Thread.join` can now raise this exception. diff --git a/Doc/library/faulthandler.rst b/Doc/library/faulthandler.rst index e34b067..5058b85 100644 --- a/Doc/library/faulthandler.rst +++ b/Doc/library/faulthandler.rst @@ -69,7 +69,7 @@ Dumping the traceback Dumping the C stack ------------------- -.. versionadded:: next +.. versionadded:: 3.14 .. function:: dump_c_stack(file=sys.stderr) @@ -130,7 +130,7 @@ Fault handler state Only the current thread is dumped if the :term:`GIL` is disabled to prevent the risk of data races. - .. versionchanged:: next + .. versionchanged:: 3.14 The dump now displays the C stack trace if *c_stack* is true. .. function:: disable() diff --git a/Doc/library/fcntl.rst b/Doc/library/fcntl.rst index b4ea3e7..c8ce86c 100644 --- a/Doc/library/fcntl.rst +++ b/Doc/library/fcntl.rst @@ -79,7 +79,7 @@ descriptor. On macOS and NetBSD, the :mod:`!fcntl` module exposes the ``F_GETNOSIGPIPE`` and ``F_SETNOSIGPIPE`` constant. -.. versionchanged:: next +.. versionchanged:: 3.14 On Linux >= 6.1, the :mod:`!fcntl` module exposes the ``F_DUPFD_QUERY`` to query a file descriptor pointing to the same file. @@ -121,7 +121,7 @@ The module defines the following functions: .. audit-event:: fcntl.fcntl fd,cmd,arg fcntl.fcntl - .. versionchanged:: next + .. versionchanged:: 3.14 Add support of arbitrary :term:`bytes-like objects <bytes-like object>`, not only :class:`bytes`. @@ -181,7 +181,7 @@ The module defines the following functions: .. audit-event:: fcntl.ioctl fd,request,arg fcntl.ioctl - .. versionchanged:: next + .. versionchanged:: 3.14 The GIL is always released during a system call. System calls failing with EINTR are automatically retried. diff --git a/Doc/library/getpass.rst b/Doc/library/getpass.rst index 38b78dc..0fb0fc8 100644 --- a/Doc/library/getpass.rst +++ b/Doc/library/getpass.rst @@ -39,7 +39,7 @@ The :mod:`getpass` module provides two functions: If you call getpass from within IDLE, the input may be done in the terminal you launched IDLE from rather than the idle window itself. - .. versionchanged:: next + .. versionchanged:: 3.14 Added the *echo_char* parameter for keyboard feedback. .. exception:: GetPassWarning diff --git a/Doc/library/hashlib.rst b/Doc/library/hashlib.rst index ff15a08..bb2d2fa 100644 --- a/Doc/library/hashlib.rst +++ b/Doc/library/hashlib.rst @@ -302,7 +302,7 @@ a file or file-like object. .. versionadded:: 3.11 - .. versionchanged:: next + .. versionchanged:: 3.14 Now raises a :exc:`BlockingIOError` if the file is opened in blocking mode. Previously, spurious null bytes were added to the digest. diff --git a/Doc/library/heapq.rst b/Doc/library/heapq.rst index 2bd0162..922ba0c 100644 --- a/Doc/library/heapq.rst +++ b/Doc/library/heapq.rst @@ -105,7 +105,7 @@ For max-heaps, the following functions are provided: Transform list *x* into a max-heap, in-place, in linear time. - .. versionadded:: next + .. versionadded:: 3.14 .. function:: heappush_max(heap, item) @@ -113,7 +113,7 @@ For max-heaps, the following functions are provided: Push the value *item* onto the max-heap *heap*, maintaining the max-heap invariant. - .. versionadded:: next + .. versionadded:: 3.14 .. function:: heappop_max(heap) @@ -122,7 +122,7 @@ For max-heaps, the following functions are provided: max-heap invariant. If the max-heap is empty, :exc:`IndexError` is raised. To access the largest item without popping it, use ``maxheap[0]``. - .. versionadded:: next + .. versionadded:: 3.14 .. function:: heappushpop_max(heap, item) @@ -132,7 +132,7 @@ For max-heaps, the following functions are provided: The combined action runs more efficiently than :func:`heappush_max` followed by a separate call to :func:`heappop_max`. - .. versionadded:: next + .. versionadded:: 3.14 .. function:: heapreplace_max(heap, item) @@ -145,7 +145,7 @@ For max-heaps, the following functions are provided: The value returned may be smaller than the *item* added. Refer to the analogous function :func:`heapreplace` for detailed usage notes. - .. versionadded:: next + .. versionadded:: 3.14 The module also offers three general purpose functions based on heaps. diff --git a/Doc/library/logging.handlers.rst b/Doc/library/logging.handlers.rst index 72312b5..63ef533 100644 --- a/Doc/library/logging.handlers.rst +++ b/Doc/library/logging.handlers.rst @@ -1148,7 +1148,7 @@ possible, while any potentially slow operations (such as sending an email via .. versionchanged:: 3.5 The ``respect_handler_level`` argument was added. - .. versionchanged:: next + .. versionchanged:: 3.14 :class:`QueueListener` can now be used as a context manager via :keyword:`with`. When entering the context, the listener is started. When exiting the context, the listener is stopped. @@ -1186,7 +1186,7 @@ possible, while any potentially slow operations (such as sending an email via This starts up a background thread to monitor the queue for LogRecords to process. - .. versionchanged:: next + .. versionchanged:: 3.14 Raises :exc:`RuntimeError` if called and the listener is already running. diff --git a/Doc/library/multiprocessing.rst b/Doc/library/multiprocessing.rst index e44142a..6c43d5f 100644 --- a/Doc/library/multiprocessing.rst +++ b/Doc/library/multiprocessing.rst @@ -687,7 +687,7 @@ The :mod:`multiprocessing` package mostly replicates the API of the :attr:`exitcode` you may simply catch :exc:`KeyboardInterrupt` and call ``exit(your_code)``. - .. versionadded:: next + .. versionadded:: 3.14 .. method:: terminate() diff --git a/Doc/library/pathlib.rst b/Doc/library/pathlib.rst index acb9181..7d7692d 100644 --- a/Doc/library/pathlib.rst +++ b/Doc/library/pathlib.rst @@ -871,7 +871,7 @@ conforming to :rfc:`8089`. .. versionadded:: 3.13 - .. versionchanged:: next + .. versionchanged:: 3.14 The URL authority is discarded if it matches the local hostname. Otherwise, if the authority isn't empty or ``localhost``, then on Windows a UNC path is returned (as before), and on other platforms a diff --git a/Doc/library/re.rst b/Doc/library/re.rst index 0ee2d68..eb3b1e5 100644 --- a/Doc/library/re.rst +++ b/Doc/library/re.rst @@ -667,7 +667,7 @@ character ``'$'``. ``\z`` Matches only at the end of the string. - .. versionadded:: next + .. versionadded:: 3.14 ``\Z`` The same as ``\z``. For compatibility with old Python versions. diff --git a/Doc/library/readline.rst b/Doc/library/readline.rst index 29e560c..f649fce 100644 --- a/Doc/library/readline.rst +++ b/Doc/library/readline.rst @@ -76,7 +76,7 @@ The following functions relate to the init file and user configuration: if given, and :code:`"<readline_init_file>"` otherwise, regardless of which file the library resolves. - .. versionchanged:: next + .. versionchanged:: 3.14 The auditing event was added. @@ -119,7 +119,7 @@ The following functions operate on a history file: and raises an :ref:`auditing event <auditing>` ``open`` with the file name if given and :code:`"~/.history"` otherwise. - .. versionchanged:: next + .. versionchanged:: 3.14 The auditing event was added. @@ -131,7 +131,7 @@ The following functions operate on a history file: :ref:`auditing event <auditing>` ``open`` with the file name if given and :code:`"~/.history"` otherwise. - .. versionchanged:: next + .. versionchanged:: 3.14 The auditing event was added. @@ -146,7 +146,7 @@ The following functions operate on a history file: .. versionadded:: 3.5 - .. versionchanged:: next + .. versionchanged:: 3.14 The auditing event was added. diff --git a/Doc/library/socket.rst b/Doc/library/socket.rst index 3c8dc26..8fd5187 100644 --- a/Doc/library/socket.rst +++ b/Doc/library/socket.rst @@ -170,7 +170,7 @@ created. Socket addresses are represented as follows: .. versionchanged:: 3.13.3 FreeBSD support added. - .. versionchanged:: next + .. versionchanged:: 3.14 Added ``channel`` field. ``device_id`` not packed in a tuple is now accepted. @@ -178,7 +178,7 @@ created. Socket addresses are represented as follows: the Bluetooth address as a string or a :class:`bytes` object. (ex. ``'12:23:34:45:56:67'`` or ``b'12:23:34:45:56:67'``) - .. versionchanged:: next + .. versionchanged:: 3.14 FreeBSD support added. - :const:`AF_ALG` is a Linux-only socket based interface to Kernel @@ -498,7 +498,7 @@ Constants .. versionchanged:: 3.11 NetBSD support was added. - .. versionchanged:: next + .. versionchanged:: 3.14 Restored missing ``CAN_RAW_ERR_FILTER`` on Linux. .. data:: CAN_BCM @@ -709,7 +709,7 @@ Constants :const:`!SO_BTH_*` are only available on Windows. Other constants may be available on Linux and various BSD platforms. - .. versionadded:: next + .. versionadded:: 3.14 .. data:: HCI_FILTER HCI_TIME_STAMP @@ -720,7 +720,7 @@ Constants Option names for use with :const:`BTPROTO_HCI`. Availability and format of the option values depend on platform. - .. versionchanged:: next + .. versionchanged:: 3.14 Added :const:`!SO_HCI_EVT_FILTER` and :const:`!SO_HCI_PKT_FILTER` on NetBSD and DragonFly BSD. Added :const:`!HCI_DATA_DIR` on FreeBSD, NetBSD and DragonFly BSD. @@ -732,7 +732,7 @@ Constants .. availability:: Linux - .. versionadded:: next + .. versionadded:: 3.14 .. data:: HCI_CHANNEL_RAW HCI_CHANNEL_USER @@ -744,7 +744,7 @@ Constants .. availability:: Linux - .. versionadded:: next + .. versionadded:: 3.14 .. data:: AF_QIPCRTR diff --git a/Doc/library/sys.rst b/Doc/library/sys.rst index a5c4ffa..55e442b 100644 --- a/Doc/library/sys.rst +++ b/Doc/library/sys.rst @@ -1292,7 +1292,7 @@ always available. Unless explicitly noted otherwise, all variables are read-only ``sys._jit`` is not guaranteed to exist or behave the same way in all Python implementations, versions, or build configurations. - .. versionadded:: next + .. versionadded:: 3.14 .. function:: _jit.is_available() diff --git a/Doc/library/tarfile.rst b/Doc/library/tarfile.rst index 8e9775d..f9cb549 100644 --- a/Doc/library/tarfile.rst +++ b/Doc/library/tarfile.rst @@ -167,7 +167,7 @@ Some facts and figures: .. versionchanged:: 3.12 The *compresslevel* keyword argument also works for streams. - .. versionchanged:: next + .. versionchanged:: 3.14 The *preset* keyword argument also works for streams. diff --git a/Doc/library/threading.rst b/Doc/library/threading.rst index de9ee42..249c0a5 100644 --- a/Doc/library/threading.rst +++ b/Doc/library/threading.rst @@ -561,7 +561,7 @@ since it is impossible to detect the termination of alien threads. of :term:`Python finalization <interpreter shutdown>` :meth:`!join` raises a :exc:`PythonFinalizationError`. - .. versionchanged:: next + .. versionchanged:: 3.14 May raise :exc:`PythonFinalizationError`. diff --git a/Doc/library/token.rst b/Doc/library/token.rst index 1529d17..1f92b5d 100644 --- a/Doc/library/token.rst +++ b/Doc/library/token.rst @@ -140,7 +140,7 @@ The token constants are: The token string includes the prefix and the opening quote(s), but none of the contents of the literal. - .. versionadded:: next + .. versionadded:: 3.14 .. data:: TSTRING_MIDDLE @@ -154,7 +154,7 @@ The token constants are: :data:`LBRACE`, :data:`RBRACE`, :data:`EXCLAMATION` and :data:`COLON` tokens. - .. versionadded:: next + .. versionadded:: 3.14 .. data:: TSTRING_END @@ -164,7 +164,7 @@ The token constants are: The token string contains the closing quote(s). - .. versionadded:: next + .. versionadded:: 3.14 .. data:: ENDMARKER diff --git a/Doc/library/urllib.request.rst b/Doc/library/urllib.request.rst index 2348271..b0f2672 100644 --- a/Doc/library/urllib.request.rst +++ b/Doc/library/urllib.request.rst @@ -171,7 +171,7 @@ The :mod:`urllib.request` module defines the following functions: sections. For example, the path ``/etc/hosts`` is converted to the URL ``///etc/hosts``. - .. versionchanged:: next + .. versionchanged:: 3.14 The *add_scheme* parameter was added. @@ -204,13 +204,13 @@ The :mod:`urllib.request` module defines the following functions: characters not following a drive letter no longer cause an :exc:`OSError` exception to be raised on Windows. - .. versionchanged:: next + .. versionchanged:: 3.14 The URL authority is discarded if it matches the local hostname. Otherwise, if the authority isn't empty or ``localhost``, then on Windows a UNC path is returned (as before), and on other platforms a :exc:`~urllib.error.URLError` is raised. - .. versionchanged:: next + .. versionchanged:: 3.14 The *require_scheme* and *resolve_host* parameters were added. diff --git a/Doc/library/webbrowser.rst b/Doc/library/webbrowser.rst index cbb2b06..fd6abc7 100644 --- a/Doc/library/webbrowser.rst +++ b/Doc/library/webbrowser.rst @@ -29,7 +29,7 @@ already registered browsers this browser is added to the front of the search lis if the part does not contain ``%s``, it is simply interpreted as the name of the browser to launch. [1]_ -.. versionchanged:: next +.. versionchanged:: 3.14 The :envvar:`BROWSER` variable can now also be used to reorder the list of platform defaults. This is particularly useful on macOS where the platform diff --git a/Doc/reference/datamodel.rst b/Doc/reference/datamodel.rst index ea5b84b..005a768f 100644 --- a/Doc/reference/datamodel.rst +++ b/Doc/reference/datamodel.rst @@ -3346,7 +3346,7 @@ left undefined. argument if the three-argument version of the built-in :func:`pow` function is to be supported. - .. versionchanged:: next + .. versionchanged:: 3.14 Three-argument :func:`pow` now try calling :meth:`~object.__rpow__` if necessary. Previously it was only called in two-argument :func:`!pow` and the binary diff --git a/Doc/using/cmdline.rst b/Doc/using/cmdline.rst index 0095046..40a46a6 100644 --- a/Doc/using/cmdline.rst +++ b/Doc/using/cmdline.rst @@ -73,7 +73,7 @@ source. .. audit-event:: cpython.run_command command cmdoption-c - .. versionchanged:: next + .. versionchanged:: 3.14 *command* is automatically dedented before execution. .. option:: -m <module-name> @@ -549,7 +549,7 @@ Miscellaneous options .. versionadded:: 3.7 - .. versionchanged:: next + .. versionchanged:: 3.14 Added ``-X importtime=2`` to also trace imports of loaded modules, and reserved values other than ``1`` and ``2`` for future use. @@ -680,7 +680,7 @@ Miscellaneous options .. versionchanged:: 3.10 Removed the ``-X oldparser`` option. -.. versionremoved:: next +.. versionremoved:: 3.14 :option:`!-J` is no longer reserved for use by Jython_, and now has no special meaning. @@ -999,7 +999,7 @@ conflict. .. versionadded:: 3.7 - .. versionchanged:: next + .. versionchanged:: 3.14 Added ``PYTHONPROFILEIMPORTTIME=2`` to also trace imports of loaded modules. |