From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Tue, 2 Dec 2025 13:32:04 +0000 (+0100)
Subject: [3.13] Document None for timeout argument of select.select (GH-142177)
X-Git-Tag: v3.13.11~10^2
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=caf1794b887b1e6ce470fd2a753ec87501be31b5;p=thirdparty%2FPython%2Fcpython.git

[3.13] Document None for timeout argument of select.select (GH-142177)

cherry picked from commit 82274c491a48c8cebbc1a1350a9cc67bb423caff (GH-142182)

Co-authored-by: Petr Viktorin <encukou@gmail.com>
---

diff --git a/Doc/library/select.rst b/Doc/library/select.rst
index bbac9bc4bbe3..2e3db8ebb324 100644
--- a/Doc/library/select.rst
+++ b/Doc/library/select.rst
@@ -115,7 +115,7 @@ The module defines the following:
    :ref:`kevent-objects` below for the methods supported by kevent objects.
 
 
-.. function:: select(rlist, wlist, xlist[, timeout])
+.. function:: select(rlist, wlist, xlist, timeout=None)
 
    This is a straightforward interface to the Unix :c:func:`!select` system call.
    The first three arguments are iterables of 'waitable objects': either
@@ -130,7 +130,8 @@ The module defines the following:
    Empty iterables are allowed, but acceptance of three empty iterables is
    platform-dependent. (It is known to work on Unix but not on Windows.)  The
    optional *timeout* argument specifies a time-out as a floating-point number
-   in seconds.  When the *timeout* argument is omitted the function blocks until
+   in seconds.
+   When the *timeout* argument is omitted or ``None``, the function blocks until
    at least one file descriptor is ready.  A time-out value of zero specifies a
    poll and never blocks.