From 5d0a43a0b280e9a2f4f29b876b3437432adb26a8 Mon Sep 17 00:00:00 2001 From: AN Long Date: Tue, 30 Dec 2025 23:21:41 +0900 Subject: [PATCH] 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