From 5d0a43a0b280e9a2f4f29b876b3437432adb26a8 Mon Sep 17 00:00:00 2001 From: AN Long Date: Tue, 30 Dec 2025 23:21:41 +0900 Subject: [PATCH 1/2] Update the document for epoll.poll in select.rst --- Doc/library/select.rst | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/Doc/library/select.rst b/Doc/library/select.rst index 62b5161fb80634..9d4bd1f8c19907 100644 --- a/Doc/library/select.rst +++ b/Doc/library/select.rst @@ -375,10 +375,16 @@ Edge and Level Trigger Polling (epoll) Objects .. method:: epoll.poll(timeout=None, maxevents=-1) - Wait for events. + Wait for events. Return a list of ``(fd, eventmask)`` tuples if there's any + event. Otherwise, an empty list is returned. See the :ref:`epoll-objects` + section above for the event constants. + If *timeout* is given, it specifies the length of time in seconds (may be non-integer) which the system will wait for events before returning. + *maxevents* specifies the maximum number of events to return. It must be + greater than 0, or ``-1`` to use the default (``FD_SETSIZE-1``). + .. versionchanged:: 3.5 The function is now retried with a recomputed timeout when interrupted by a signal, except if the signal handler raises an exception (see From e9c2315bd435788b57bfbcce1f0a675a6ccc1032 Mon Sep 17 00:00:00 2001 From: AN Long Date: Fri, 2 Jan 2026 09:51:15 +0900 Subject: [PATCH 2/2] Update Doc/library/select.rst Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com> --- Doc/library/select.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Doc/library/select.rst b/Doc/library/select.rst index 9d4bd1f8c19907..a353a21aa9527e 100644 --- a/Doc/library/select.rst +++ b/Doc/library/select.rst @@ -383,7 +383,7 @@ Edge and Level Trigger Polling (epoll) Objects (may be non-integer) which the system will wait for events before returning. *maxevents* specifies the maximum number of events to return. It must be - greater than 0, or ``-1`` to use the default (``FD_SETSIZE-1``). + greater than 0, or ``-1`` to use the default (``FD_SETSIZE - 1``). .. versionchanged:: 3.5 The function is now retried with a recomputed timeout when interrupted by