Format None, True, False and NotImplemented as literals (GH-118758)

This commit is contained in:
Serhiy Storchaka 2024-05-08 22:35:16 +03:00 committed by GitHub
parent bcb435ee8f
commit 05c2fe1acd
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
39 changed files with 85 additions and 83 deletions

View File

@ -65,7 +65,7 @@ Object Protocol
Properly handle returning :c:data:`Py_NotImplemented` from within a C Properly handle returning :c:data:`Py_NotImplemented` from within a C
function (that is, create a new :term:`strong reference` function (that is, create a new :term:`strong reference`
to NotImplemented and return it). to :const:`NotImplemented` and return it).
.. c:macro:: Py_PRINT_RAW .. c:macro:: Py_PRINT_RAW

View File

@ -169,14 +169,14 @@ Lock objects have the following methods:
time can acquire a lock --- that's their reason for existence). time can acquire a lock --- that's their reason for existence).
If the *blocking* argument is present, the action depends on its If the *blocking* argument is present, the action depends on its
value: if it is False, the lock is only acquired if it can be acquired value: if it is false, the lock is only acquired if it can be acquired
immediately without waiting, while if it is True, the lock is acquired immediately without waiting, while if it is true, the lock is acquired
unconditionally as above. unconditionally as above.
If the floating-point *timeout* argument is present and positive, it If the floating-point *timeout* argument is present and positive, it
specifies the maximum wait time in seconds before returning. A negative specifies the maximum wait time in seconds before returning. A negative
*timeout* argument specifies an unbounded wait. You cannot specify *timeout* argument specifies an unbounded wait. You cannot specify
a *timeout* if *blocking* is False. a *timeout* if *blocking* is false.
The return value is ``True`` if the lock is acquired successfully, The return value is ``True`` if the lock is acquired successfully,
``False`` if not. ``False`` if not.

View File

@ -796,7 +796,7 @@ Creating network servers
:class:`str`, :class:`bytes`, and :class:`~pathlib.Path` paths :class:`str`, :class:`bytes`, and :class:`~pathlib.Path` paths
are supported. are supported.
If *cleanup_socket* is True then the Unix socket will automatically If *cleanup_socket* is true then the Unix socket will automatically
be removed from the filesystem when the server is closed, unless the be removed from the filesystem when the server is closed, unless the
socket has been replaced after the server has been created. socket has been replaced after the server has been created.

View File

@ -538,7 +538,7 @@ Running Tasks Concurrently
# [2, 6, 24] # [2, 6, 24]
.. note:: .. note::
If *return_exceptions* is False, cancelling gather() after it If *return_exceptions* is false, cancelling gather() after it
has been marked done won't cancel any submitted awaitables. has been marked done won't cancel any submitted awaitables.
For instance, gather can be marked done after propagating an For instance, gather can be marked done after propagating an
exception to the caller, therefore, calling ``gather.cancel()`` exception to the caller, therefore, calling ``gather.cancel()``

View File

@ -86,7 +86,7 @@ The :mod:`bdb` module also defines two classes:
.. attribute:: temporary .. attribute:: temporary
True if a :class:`Breakpoint` at (file, line) is temporary. ``True`` if a :class:`Breakpoint` at (file, line) is temporary.
.. attribute:: cond .. attribute:: cond
@ -99,7 +99,7 @@ The :mod:`bdb` module also defines two classes:
.. attribute:: enabled .. attribute:: enabled
True if :class:`Breakpoint` is enabled. ``True`` if :class:`Breakpoint` is enabled.
.. attribute:: bpbynumber .. attribute:: bpbynumber
@ -215,22 +215,22 @@ The :mod:`bdb` module also defines two classes:
.. method:: is_skipped_line(module_name) .. method:: is_skipped_line(module_name)
Return True if *module_name* matches any skip pattern. Return ``True`` if *module_name* matches any skip pattern.
.. method:: stop_here(frame) .. method:: stop_here(frame)
Return True if *frame* is below the starting frame in the stack. Return ``True`` if *frame* is below the starting frame in the stack.
.. method:: break_here(frame) .. method:: break_here(frame)
Return True if there is an effective breakpoint for this line. Return ``True`` if there is an effective breakpoint for this line.
Check whether a line or function breakpoint exists and is in effect. Delete temporary Check whether a line or function breakpoint exists and is in effect. Delete temporary
breakpoints based on information from :func:`effective`. breakpoints based on information from :func:`effective`.
.. method:: break_anywhere(frame) .. method:: break_anywhere(frame)
Return True if any breakpoint exists for *frame*'s filename. Return ``True`` if any breakpoint exists for *frame*'s filename.
Derived classes should override these methods to gain control over debugger Derived classes should override these methods to gain control over debugger
operation. operation.
@ -348,7 +348,7 @@ The :mod:`bdb` module also defines two classes:
.. method:: get_break(filename, lineno) .. method:: get_break(filename, lineno)
Return True if there is a breakpoint for *lineno* in *filename*. Return ``True`` if there is a breakpoint for *lineno* in *filename*.
.. method:: get_breaks(filename, lineno) .. method:: get_breaks(filename, lineno)
@ -412,7 +412,7 @@ Finally, the module defines the following functions:
.. function:: checkfuncname(b, frame) .. function:: checkfuncname(b, frame)
Return True if we should break here, depending on the way the Return ``True`` if we should break here, depending on the way the
:class:`Breakpoint` *b* was set. :class:`Breakpoint` *b* was set.
If it was set via line number, it checks if If it was set via line number, it checks if
@ -431,14 +431,14 @@ Finally, the module defines the following functions:
:attr:`bplist <bdb.Breakpoint.bplist>` for the :attr:`bplist <bdb.Breakpoint.bplist>` for the
(:attr:`file <bdb.Breakpoint.file>`, :attr:`line <bdb.Breakpoint.line>`) (:attr:`file <bdb.Breakpoint.file>`, :attr:`line <bdb.Breakpoint.line>`)
(which must exist) that is :attr:`enabled <bdb.Breakpoint.enabled>`, for (which must exist) that is :attr:`enabled <bdb.Breakpoint.enabled>`, for
which :func:`checkfuncname` is True, and that has neither a False which :func:`checkfuncname` is true, and that has neither a false
:attr:`condition <bdb.Breakpoint.cond>` nor positive :attr:`condition <bdb.Breakpoint.cond>` nor positive
:attr:`ignore <bdb.Breakpoint.ignore>` count. The *flag*, meaning that a :attr:`ignore <bdb.Breakpoint.ignore>` count. The *flag*, meaning that a
temporary breakpoint should be deleted, is False only when the temporary breakpoint should be deleted, is ``False`` only when the
:attr:`cond <bdb.Breakpoint.cond>` cannot be evaluated (in which case, :attr:`cond <bdb.Breakpoint.cond>` cannot be evaluated (in which case,
:attr:`ignore <bdb.Breakpoint.ignore>` count is ignored). :attr:`ignore <bdb.Breakpoint.ignore>` count is ignored).
If no such entry exists, then (None, None) is returned. If no such entry exists, then ``(None, None)`` is returned.
.. function:: set_trace() .. function:: set_trace()

View File

@ -27,7 +27,7 @@ build applications which provide an interactive interpreter prompt.
Closely emulate the behavior of the interactive Python interpreter. This class Closely emulate the behavior of the interactive Python interpreter. This class
builds on :class:`InteractiveInterpreter` and adds prompting using the familiar builds on :class:`InteractiveInterpreter` and adds prompting using the familiar
``sys.ps1`` and ``sys.ps2``, and input buffering. If *local_exit* is True, ``sys.ps1`` and ``sys.ps2``, and input buffering. If *local_exit* is true,
``exit()`` and ``quit()`` in the console will not raise :exc:`SystemExit`, but ``exit()`` and ``quit()`` in the console will not raise :exc:`SystemExit`, but
instead return to the calling code. instead return to the calling code.

View File

@ -226,7 +226,7 @@ Public functions
The *invalidation_mode* parameter was added. The *invalidation_mode* parameter was added.
.. versionchanged:: 3.7.2 .. versionchanged:: 3.7.2
The *invalidation_mode* parameter's default value is updated to None. The *invalidation_mode* parameter's default value is updated to ``None``.
.. versionchanged:: 3.8 .. versionchanged:: 3.8
Setting *workers* to 0 now chooses the optimal number of cores. Setting *workers* to 0 now chooses the optimal number of cores.
@ -289,7 +289,7 @@ Public functions
The *invalidation_mode* parameter was added. The *invalidation_mode* parameter was added.
.. versionchanged:: 3.7.2 .. versionchanged:: 3.7.2
The *invalidation_mode* parameter's default value is updated to None. The *invalidation_mode* parameter's default value is updated to ``None``.
.. versionchanged:: 3.9 .. versionchanged:: 3.9
Added *stripdir*, *prependdir*, *limit_sl_dest* and *hardlink_dupes* arguments. Added *stripdir*, *prependdir*, *limit_sl_dest* and *hardlink_dupes* arguments.
@ -318,7 +318,7 @@ Public functions
The *invalidation_mode* parameter was added. The *invalidation_mode* parameter was added.
.. versionchanged:: 3.7.2 .. versionchanged:: 3.7.2
The *invalidation_mode* parameter's default value is updated to None. The *invalidation_mode* parameter's default value is updated to ``None``.
To force a recompile of all the :file:`.py` files in the :file:`Lib/` To force a recompile of all the :file:`.py` files in the :file:`Lib/`
subdirectory and all its subdirectories:: subdirectory and all its subdirectories::

View File

@ -349,8 +349,8 @@ The :mod:`csv` module defines the following constants:
``None``. This is similar to :data:`QUOTE_ALL`, except that if a ``None``. This is similar to :data:`QUOTE_ALL`, except that if a
field value is ``None`` an empty (unquoted) string is written. field value is ``None`` an empty (unquoted) string is written.
Instructs :class:`reader` objects to interpret an empty (unquoted) field as None and Instructs :class:`reader` objects to interpret an empty (unquoted) field
to otherwise behave as :data:`QUOTE_ALL`. as ``None`` and to otherwise behave as :data:`QUOTE_ALL`.
.. versionadded:: 3.12 .. versionadded:: 3.12

View File

@ -278,7 +278,7 @@ Module contents
generated equality and comparison methods (:meth:`~object.__eq__`, generated equality and comparison methods (:meth:`~object.__eq__`,
:meth:`~object.__gt__`, et al.). :meth:`~object.__gt__`, et al.).
- *metadata*: This can be a mapping or None. None is treated as - *metadata*: This can be a mapping or ``None``. ``None`` is treated as
an empty dict. This value is wrapped in an empty dict. This value is wrapped in
:func:`~types.MappingProxyType` to make it read-only, and exposed :func:`~types.MappingProxyType` to make it read-only, and exposed
on the :class:`Field` object. It is not used at all by Data on the :class:`Field` object. It is not used at all by Data

View File

@ -325,7 +325,7 @@ The :mod:`functools` module defines the following functions:
.. versionadded:: 3.2 .. versionadded:: 3.2
.. versionchanged:: 3.4 .. versionchanged:: 3.4
Returning NotImplemented from the underlying comparison function for Returning ``NotImplemented`` from the underlying comparison function for
unrecognised types is now supported. unrecognised types is now supported.
.. function:: partial(func, /, *args, **keywords) .. function:: partial(func, /, *args, **keywords)

View File

@ -69,7 +69,7 @@ The :mod:`gc` module provides the following functions:
.. function:: get_objects(generation=None) .. function:: get_objects(generation=None)
Returns a list of all objects tracked by the collector, excluding the list Returns a list of all objects tracked by the collector, excluding the list
returned. If *generation* is not None, return only the objects tracked by returned. If *generation* is not ``None``, return only the objects tracked by
the collector that are in that generation. the collector that are in that generation.
.. versionchanged:: 3.8 .. versionchanged:: 3.8

View File

@ -102,7 +102,7 @@ The module defines the following items:
The optional *mtime* argument is the timestamp requested by gzip. The time The optional *mtime* argument is the timestamp requested by gzip. The time
is in Unix format, i.e., seconds since 00:00:00 UTC, January 1, 1970. is in Unix format, i.e., seconds since 00:00:00 UTC, January 1, 1970.
If *mtime* is omitted or None, the current time is used. Use *mtime* = 0 If *mtime* is omitted or ``None``, the current time is used. Use *mtime* = 0
to generate a compressed stream that does not depend on creation time. to generate a compressed stream that does not depend on creation time.
See below for the :attr:`mtime` attribute that is set when decompressing. See below for the :attr:`mtime` attribute that is set when decompressing.

View File

@ -39,7 +39,7 @@ base class:
initialized. If *host* is not specified, ``''`` (the local host) is used. If initialized. If *host* is not specified, ``''`` (the local host) is used. If
*port* is omitted, the standard IMAP4 port (143) is used. The optional *timeout* *port* is omitted, the standard IMAP4 port (143) is used. The optional *timeout*
parameter specifies a timeout in seconds for the connection attempt. parameter specifies a timeout in seconds for the connection attempt.
If timeout is not given or is None, the global default socket timeout is used. If timeout is not given or is ``None``, the global default socket timeout is used.
The :class:`IMAP4` class supports the :keyword:`with` statement. When used The :class:`IMAP4` class supports the :keyword:`with` statement. When used
like this, the IMAP4 ``LOGOUT`` command is issued automatically when the like this, the IMAP4 ``LOGOUT`` command is issued automatically when the
@ -97,7 +97,7 @@ There's also a subclass for secure connections:
best practices. best practices.
The optional *timeout* parameter specifies a timeout in seconds for the The optional *timeout* parameter specifies a timeout in seconds for the
connection attempt. If timeout is not given or is None, the global default connection attempt. If timeout is not given or is ``None``, the global default
socket timeout is used. socket timeout is used.
.. versionchanged:: 3.3 .. versionchanged:: 3.3
@ -360,7 +360,7 @@ An :class:`IMAP4` instance has the following methods:
Opens socket to *port* at *host*. The optional *timeout* parameter Opens socket to *port* at *host*. The optional *timeout* parameter
specifies a timeout in seconds for the connection attempt. specifies a timeout in seconds for the connection attempt.
If timeout is not given or is None, the global default socket timeout If timeout is not given or is ``None``, the global default socket timeout
is used. Also note that if the *timeout* parameter is set to be zero, is used. Also note that if the *timeout* parameter is set to be zero,
it will raise a :class:`ValueError` to reject creating a non-blocking socket. it will raise a :class:`ValueError` to reject creating a non-blocking socket.
This method is implicitly called by the :class:`IMAP4` constructor. This method is implicitly called by the :class:`IMAP4` constructor.

View File

@ -103,11 +103,11 @@
.. abstractmethod:: is_dir() .. abstractmethod:: is_dir()
Return True if self is a directory. Return ``True`` if self is a directory.
.. abstractmethod:: is_file() .. abstractmethod:: is_file()
Return True if self is a file. Return ``True`` if self is a file.
.. abstractmethod:: joinpath(*pathsegments) .. abstractmethod:: joinpath(*pathsegments)

View File

@ -66,7 +66,7 @@ and :meth:`flush` methods).
:param stream: The stream that the handler should use. :param stream: The stream that the handler should use.
:return: the old stream, if the stream was changed, or *None* if it wasn't. :return: the old stream, if the stream was changed, or ``None`` if it wasn't.
.. versionadded:: 3.7 .. versionadded:: 3.7

View File

@ -268,7 +268,7 @@ Number-theoretic and representation functions
Evaluates to ``n! / (n - k)!`` when ``k <= n`` and evaluates Evaluates to ``n! / (n - k)!`` when ``k <= n`` and evaluates
to zero when ``k > n``. to zero when ``k > n``.
If *k* is not specified or is None, then *k* defaults to *n* If *k* is not specified or is ``None``, then *k* defaults to *n*
and the function returns ``n!``. and the function returns ``n!``.
Raises :exc:`TypeError` if either of the arguments are not integers. Raises :exc:`TypeError` if either of the arguments are not integers.

View File

@ -2483,9 +2483,9 @@ multiple connections at the same time.
generally be omitted since it can usually be inferred from the format of generally be omitted since it can usually be inferred from the format of
*address*. (See :ref:`multiprocessing-address-formats`) *address*. (See :ref:`multiprocessing-address-formats`)
If *authkey* is given and not None, it should be a byte string and will be If *authkey* is given and not ``None``, it should be a byte string and will be
used as the secret key for an HMAC-based authentication challenge. No used as the secret key for an HMAC-based authentication challenge. No
authentication is done if *authkey* is None. authentication is done if *authkey* is ``None``.
:exc:`~multiprocessing.AuthenticationError` is raised if authentication fails. :exc:`~multiprocessing.AuthenticationError` is raised if authentication fails.
See :ref:`multiprocessing-auth-keys`. See :ref:`multiprocessing-auth-keys`.
@ -2518,9 +2518,9 @@ multiple connections at the same time.
to the :meth:`~socket.socket.listen` method of the socket once it has been to the :meth:`~socket.socket.listen` method of the socket once it has been
bound. bound.
If *authkey* is given and not None, it should be a byte string and will be If *authkey* is given and not ``None``, it should be a byte string and will be
used as the secret key for an HMAC-based authentication challenge. No used as the secret key for an HMAC-based authentication challenge. No
authentication is done if *authkey* is None. authentication is done if *authkey* is ``None``.
:exc:`~multiprocessing.AuthenticationError` is raised if authentication fails. :exc:`~multiprocessing.AuthenticationError` is raised if authentication fails.
See :ref:`multiprocessing-auth-keys`. See :ref:`multiprocessing-auth-keys`.

View File

@ -923,7 +923,7 @@ as internal buffering of data.
Copy *count* bytes from file descriptor *src*, starting from offset Copy *count* bytes from file descriptor *src*, starting from offset
*offset_src*, to file descriptor *dst*, starting from offset *offset_dst*. *offset_src*, to file descriptor *dst*, starting from offset *offset_dst*.
If *offset_src* is None, then *src* is read from the current position; If *offset_src* is ``None``, then *src* is read from the current position;
respectively for *offset_dst*. respectively for *offset_dst*.
In Linux kernel older than 5.3, the files pointed to by *src* and *dst* In Linux kernel older than 5.3, the files pointed to by *src* and *dst*
@ -1718,7 +1718,7 @@ or `the MSDN <https://msdn.microsoft.com/en-us/library/z0kc8e3z.aspx>`_ on Windo
Transfer *count* bytes from file descriptor *src*, starting from offset Transfer *count* bytes from file descriptor *src*, starting from offset
*offset_src*, to file descriptor *dst*, starting from offset *offset_dst*. *offset_src*, to file descriptor *dst*, starting from offset *offset_dst*.
At least one of the file descriptors must refer to a pipe. If *offset_src* At least one of the file descriptors must refer to a pipe. If *offset_src*
is None, then *src* is read from the current position; respectively for is ``None``, then *src* is read from the current position; respectively for
*offset_dst*. The offset associated to the file descriptor that refers to a *offset_dst*. The offset associated to the file descriptor that refers to a
pipe must be ``None``. The files pointed to by *src* and *dst* must reside in pipe must be ``None``. The files pointed to by *src* and *dst* must reside in
the same filesystem, otherwise an :exc:`OSError` is raised with the same filesystem, otherwise an :exc:`OSError` is raised with

View File

@ -627,8 +627,8 @@ Pure paths provide the following methods and properties:
raise ValueError(error_message.format(str(self), str(formatted))) raise ValueError(error_message.format(str(self), str(formatted)))
ValueError: '/etc/passwd' is not in the subpath of '/usr' OR one path is relative and the other is absolute. ValueError: '/etc/passwd' is not in the subpath of '/usr' OR one path is relative and the other is absolute.
When *walk_up* is False (the default), the path must start with *other*. When *walk_up* is false (the default), the path must start with *other*.
When the argument is True, ``..`` entries may be added to form the When the argument is true, ``..`` entries may be added to form the
relative path. In all other cases, such as the paths referencing relative path. In all other cases, such as the paths referencing
different drives, :exc:`ValueError` is raised.:: different drives, :exc:`ValueError` is raised.::

View File

@ -314,16 +314,16 @@ The :mod:`pickle` module exports three classes, :class:`Pickler`,
map the new Python 3 names to the old module names used in Python 2, so map the new Python 3 names to the old module names used in Python 2, so
that the pickle data stream is readable with Python 2. that the pickle data stream is readable with Python 2.
If *buffer_callback* is None (the default), buffer views are If *buffer_callback* is ``None`` (the default), buffer views are
serialized into *file* as part of the pickle stream. serialized into *file* as part of the pickle stream.
If *buffer_callback* is not None, then it can be called any number If *buffer_callback* is not ``None``, then it can be called any number
of times with a buffer view. If the callback returns a false value of times with a buffer view. If the callback returns a false value
(such as None), the given buffer is :ref:`out-of-band <pickle-oob>`; (such as ``None``), the given buffer is :ref:`out-of-band <pickle-oob>`;
otherwise the buffer is serialized in-band, i.e. inside the pickle stream. otherwise the buffer is serialized in-band, i.e. inside the pickle stream.
It is an error if *buffer_callback* is not None and *protocol* is It is an error if *buffer_callback* is not ``None`` and *protocol* is
None or smaller than 5. ``None`` or smaller than 5.
.. versionchanged:: 3.8 .. versionchanged:: 3.8
The *buffer_callback* argument was added. The *buffer_callback* argument was added.
@ -420,12 +420,12 @@ The :mod:`pickle` module exports three classes, :class:`Pickler`,
instances of :class:`~datetime.datetime`, :class:`~datetime.date` and instances of :class:`~datetime.datetime`, :class:`~datetime.date` and
:class:`~datetime.time` pickled by Python 2. :class:`~datetime.time` pickled by Python 2.
If *buffers* is None (the default), then all data necessary for If *buffers* is ``None`` (the default), then all data necessary for
deserialization must be contained in the pickle stream. This means deserialization must be contained in the pickle stream. This means
that the *buffer_callback* argument was None when a :class:`Pickler` that the *buffer_callback* argument was ``None`` when a :class:`Pickler`
was instantiated (or when :func:`dump` or :func:`dumps` was called). was instantiated (or when :func:`dump` or :func:`dumps` was called).
If *buffers* is not None, it should be an iterable of buffer-enabled If *buffers* is not ``None``, it should be an iterable of buffer-enabled
objects that is consumed each time the pickle stream references objects that is consumed each time the pickle stream references
an :ref:`out-of-band <pickle-oob>` buffer view. Such buffers have been an :ref:`out-of-band <pickle-oob>` buffer view. Such buffers have been
given in order to the *buffer_callback* of a Pickler object. given in order to the *buffer_callback* of a Pickler object.

View File

@ -142,7 +142,7 @@ Class Objects
.. attribute:: parent .. attribute:: parent
For top-level classes, None. For nested classes, the parent. For top-level classes, ``None``. For nested classes, the parent.
.. versionadded:: 3.7 .. versionadded:: 3.7

View File

@ -220,7 +220,7 @@ However, for reading convenience, most of the examples show sorted sequences.
.. function:: harmonic_mean(data, weights=None) .. function:: harmonic_mean(data, weights=None)
Return the harmonic mean of *data*, a sequence or iterable of Return the harmonic mean of *data*, a sequence or iterable of
real-valued numbers. If *weights* is omitted or *None*, then real-valued numbers. If *weights* is omitted or ``None``, then
equal weighting is assumed. equal weighting is assumed.
The harmonic mean is the reciprocal of the arithmetic :func:`mean` of the The harmonic mean is the reciprocal of the arithmetic :func:`mean` of the

View File

@ -1708,7 +1708,7 @@ always available.
contain a tuple of (filename, line number, function name) tuples contain a tuple of (filename, line number, function name) tuples
describing the traceback where the coroutine object was created, describing the traceback where the coroutine object was created,
with the most recent call first. When disabled, ``cr_origin`` will with the most recent call first. When disabled, ``cr_origin`` will
be None. be ``None``.
To enable, pass a *depth* value greater than zero; this sets the To enable, pass a *depth* value greater than zero; this sets the
number of frames whose information will be captured. To disable, number of frames whose information will be captured. To disable,

View File

@ -324,7 +324,7 @@ The :mod:`test.support` module defines the following constants:
.. data:: Py_DEBUG .. data:: Py_DEBUG
True if Python was built with the :c:macro:`Py_DEBUG` macro ``True`` if Python was built with the :c:macro:`Py_DEBUG` macro
defined, that is, if defined, that is, if
Python was :ref:`built in debug mode <debug-build>`. Python was :ref:`built in debug mode <debug-build>`.

View File

@ -25,8 +25,8 @@ Selection of a target object occurs as follows:
#. Top-down search of area under mouse for target widget #. Top-down search of area under mouse for target widget
* Target widget should have a callable *dnd_accept* attribute * Target widget should have a callable *dnd_accept* attribute
* If *dnd_accept* is not present or returns None, search moves to parent widget * If *dnd_accept* is not present or returns ``None``, search moves to parent widget
* If no target widget is found, then the target object is None * If no target widget is found, then the target object is ``None``
2. Call to *<old_target>.dnd_leave(source, event)* 2. Call to *<old_target>.dnd_leave(source, event)*
#. Call to *<new_target>.dnd_enter(source, event)* #. Call to *<new_target>.dnd_enter(source, event)*

View File

@ -53,7 +53,7 @@ The :mod:`tty` module defines the following functions:
is saved before setting *fd* to raw mode; this value is returned. is saved before setting *fd* to raw mode; this value is returned.
.. versionchanged:: 3.12 .. versionchanged:: 3.12
The return value is now the original tty attributes, instead of None. The return value is now the original tty attributes, instead of ``None``.
.. function:: setcbreak(fd, when=termios.TCSAFLUSH) .. function:: setcbreak(fd, when=termios.TCSAFLUSH)
@ -67,7 +67,7 @@ The :mod:`tty` module defines the following functions:
the minimum input to 1 byte with no delay. the minimum input to 1 byte with no delay.
.. versionchanged:: 3.12 .. versionchanged:: 3.12
The return value is now the original tty attributes, instead of None. The return value is now the original tty attributes, instead of ``None``.
.. versionchanged:: 3.12.2 .. versionchanged:: 3.12.2
The ``ICRNL`` flag is no longer cleared. This restores the behavior The ``ICRNL`` flag is no longer cleared. This restores the behavior

View File

@ -2498,7 +2498,7 @@ types.
This attribute reflects *only* the value of the ``total`` argument This attribute reflects *only* the value of the ``total`` argument
to the current ``TypedDict`` class, not whether the class is semantically to the current ``TypedDict`` class, not whether the class is semantically
total. For example, a ``TypedDict`` with ``__total__`` set to True may total. For example, a ``TypedDict`` with ``__total__`` set to ``True`` may
have keys marked with :data:`NotRequired`, or it may inherit from another have keys marked with :data:`NotRequired`, or it may inherit from another
``TypedDict`` with ``total=False``. Therefore, it is generally better to use ``TypedDict`` with ``total=False``. Therefore, it is generally better to use
:attr:`__required_keys__` and :attr:`__optional_keys__` for introspection. :attr:`__required_keys__` and :attr:`__optional_keys__` for introspection.

View File

@ -218,7 +218,7 @@ The following classes are provided:
An appropriate ``Content-Type`` header should be included if the *data* An appropriate ``Content-Type`` header should be included if the *data*
argument is present. If this header has not been provided and *data* argument is present. If this header has not been provided and *data*
is not None, ``Content-Type: application/x-www-form-urlencoded`` will is not ``None``, ``Content-Type: application/x-www-form-urlencoded`` will
be added as a default. be added as a default.
The next two arguments are only of interest for correct handling The next two arguments are only of interest for correct handling

View File

@ -126,7 +126,7 @@ Python.
Another thing you might notice is that not all data can be sorted or Another thing you might notice is that not all data can be sorted or
compared. For instance, ``[None, 'hello', 10]`` doesn't sort because compared. For instance, ``[None, 'hello', 10]`` doesn't sort because
integers can't be compared to strings and *None* can't be compared to integers can't be compared to strings and ``None`` can't be compared to
other types. Also, there are some types that don't have a defined other types. Also, there are some types that don't have a defined
ordering relation. For example, ``3+4j < 5+7j`` isn't a valid ordering relation. For example, ``3+4j < 5+7j`` isn't a valid
comparison. comparison.

View File

@ -2722,7 +2722,7 @@ Importing typing.io or typing.re now prints a ``DeprecationWarning``.
.. section: Library .. section: Library
argparse actions store_const and append_const each receive a default value argparse actions store_const and append_const each receive a default value
of None when the ``const`` kwarg is not provided. Previously, this raised a of ``None`` when the ``const`` kwarg is not provided. Previously, this raised a
:exc:`TypeError`. :exc:`TypeError`.
.. ..
@ -3995,7 +3995,7 @@ operator expressions.
.. section: Documentation .. section: Documentation
Document that :class:`collections.defaultdict` parameter ``default_factory`` Document that :class:`collections.defaultdict` parameter ``default_factory``
defaults to None and is positional-only. defaults to ``None`` and is positional-only.
.. ..

View File

@ -331,8 +331,8 @@ underlying SQLite API signals memory error. Patch by Erlend E. Aasland.
.. nonce: 4MQt4r .. nonce: 4MQt4r
.. section: Library .. section: Library
pprint.pprint() now handles underscore_numbers correctly. Previously it was :func:`pprint.pprint` now handles *underscore_numbers* correctly.
always setting it to False. Previously it was always setting it to ``False``.
.. ..

View File

@ -58,10 +58,10 @@ may have prevented Python-to-Python calls respecting PEP 523.
.. nonce: -igcjS .. nonce: -igcjS
.. section: Core and Builtins .. section: Core and Builtins
Add a closure keyword-only parameter to exec(). It can only be specified Add a closure keyword-only parameter to :func:`exec()`. It can only be specified
when exec-ing a code object that uses free variables. When specified, it when exec-ing a code object that uses free variables. When specified, it
must be a tuple, with exactly the number of cell variables referenced by the must be a tuple, with exactly the number of cell variables referenced by the
code object. closure has a default value of None, and it must be None if the code object. closure has a default value of ``None``, and it must be ``None`` if the
code object doesn't refer to any free variables. code object doesn't refer to any free variables.
.. ..
@ -664,8 +664,9 @@ for :func:`os.fcopyfile` available in macOs.
.. nonce: l1p7CJ .. nonce: l1p7CJ
.. section: Library .. section: Library
For @dataclass, add weakref_slot. Default is False. If True, and if For :func:`@dataclass <dataclasses.dataclass>`, add *weakref_slot*.
slots=True, add a slot named "__weakref__", which will allow instances to be The new parameter defaults to ``False``. If true, and if
``slots=True``, add a slot named ``"__weakref__"``, which will allow instances to be
weakref'd. Contributed by Eric V. Smith weakref'd. Contributed by Eric V. Smith
.. ..

View File

@ -3561,8 +3561,8 @@ with :func:`os.pidfd_open` in non-blocking mode. Patch by Kumar Aditya.
.. nonce: mkYl5q .. nonce: mkYl5q
.. section: Library .. section: Library
Implement Enum __contains__ that returns True or False to replace the Implement ``Enum.__contains__`` that returns ``True`` or ``False`` to replace the
deprecated behaviour that would sometimes raise a TypeError. deprecated behaviour that would sometimes raise a :exc:`TypeError`.
.. ..
@ -3729,7 +3729,7 @@ In a very special case, the email package tried to append the nonexistent
.. nonce: e6uKxj .. nonce: e6uKxj
.. section: Library .. section: Library
Fix :func:`ast.unparse` when ``ImportFrom.level`` is None Fix :func:`ast.unparse` when ``ImportFrom.level`` is ``None``
.. ..
@ -3791,7 +3791,7 @@ the :c:type:`time_t` type in C.
.. section: Library .. section: Library
Fixed crash resulting from calling bisect.insort() or bisect.insort_left() Fixed crash resulting from calling bisect.insort() or bisect.insort_left()
with the key argument not equal to None. with the key argument not equal to ``None``.
.. ..
@ -4080,7 +4080,7 @@ replacement strings containing group references by 2--3 times.
.. section: Library .. section: Library
Fix findtext in the xml module to only give an empty string when the text Fix findtext in the xml module to only give an empty string when the text
attribute is set to None. attribute is set to ``None``.
.. ..

View File

@ -496,7 +496,7 @@ Created packages from zipfile and test_zipfile modules, separating
Fix :attr:`~ipaddress.IPv4Address.is_private` properties in the Fix :attr:`~ipaddress.IPv4Address.is_private` properties in the
:mod:`ipaddress` module. Previously non-private networks (0.0.0.0/0) would :mod:`ipaddress` module. Previously non-private networks (0.0.0.0/0) would
return True from this method; now they correctly return False. return ``True`` from this method; now they correctly return ``False``.
.. ..

View File

@ -65,8 +65,8 @@ redundant.
.. nonce: M2n6Kg .. nonce: M2n6Kg
.. section: Core and Builtins .. section: Core and Builtins
Fix :func:`int.__sizeof__` calculation to include the 1 element ob_digit Fix :func:`int.__sizeof__` calculation to include the 1-element ``ob_digit``
array for 0 and False. array for ``0`` and ``False``.
.. ..

View File

@ -395,7 +395,7 @@ Fix bug in line numbers of instructions emitted for :keyword:`except*
.. section: Core and Builtins .. section: Core and Builtins
Clarify :exc:`SyntaxWarning` with literal ``is`` comparison by specifying Clarify :exc:`SyntaxWarning` with literal ``is`` comparison by specifying
which literal is problematic, since comparisons using ``is`` with e.g. None which literal is problematic, since comparisons using ``is`` with e.g. ``None``
and bool literals are idiomatic. and bool literals are idiomatic.
.. ..

View File

@ -3436,7 +3436,8 @@ added support for this decorator. Patch by Alex Waygood.
.. nonce: C1ahtk .. nonce: C1ahtk
.. section: Library .. section: Library
Make pydoc.doc catch bad module ImportError when output stream is not None. Make :func:`pydoc.doc` catch bad module :exc:`ImportError`
when output stream is not ``None``.
.. ..

View File

@ -228,7 +228,7 @@ cross-interpreter API. Patch by Anthony Shaw.
.. nonce: ageUWQ .. nonce: ageUWQ
.. section: Core and Builtins .. section: Core and Builtins
Add support for sharing of True and False between interpreters using the Add support for sharing of ``True`` and ``False`` between interpreters using the
cross-interpreter API. Patch by Anthony Shaw. cross-interpreter API. Patch by Anthony Shaw.
.. ..
@ -1354,8 +1354,8 @@ crash encountered after the first :meth:`tkinter.Tk` instance is destroyed.
.. section: IDLE .. section: IDLE
Add docstrings to the IDLE debugger module. Fix two bugs: initialize Add docstrings to the IDLE debugger module. Fix two bugs: initialize
Idb.botframe (should be in Bdb); in Idb.in_rpc_code, check whether ``Idb.botframe`` (should be in Bdb); in ``Idb.in_rpc_code``, check whether
prev_frame is None before trying to use it. Greatly expand test_debugger. ``prev_frame`` is ``None`` before trying to use it. Greatly expand test_debugger.
.. ..

View File

@ -269,7 +269,7 @@ Correctly compute end column offsets for multiline tokens in the
.. nonce: 4ADN7i .. nonce: 4ADN7i
.. section: Core and Builtins .. section: Core and Builtins
Fix None.__ne__(None) returning NotImplemented instead of False Fix ``None.__ne__(None)`` returning ``NotImplemented`` instead of ``False``.
.. ..