update docs

Author: picnixz

Doc/library/time.rst

@@ -397,18 +397,10 @@ Functions
 
    .. rubric:: Unix implementation
 
-   If *secs* is zero, ``select()`` is used. Otherwise:
-
    * Use ``clock_nanosleep()`` if available (resolution: 1 nanosecond);
    * Or use ``nanosleep()`` if available (resolution: 1 nanosecond);
    * Or use ``select()`` (resolution: 1 microsecond).
 
-   .. note::
-
-      To voluntarily relinquish the CPU, specify a read-time :ref:`scheduling
-      policy <os-scheduling-policy>` (see :manpage:`sched_yield(2)`) and use
-      :func:`os.sched_yield` instead.
-
    .. audit-event:: time.sleep secs
 
    .. versionchanged:: 3.5
@@ -423,10 +415,6 @@ Functions
    .. versionchanged:: 3.13
       Raises an auditing event.
 
-   .. versionchanged:: next
-      On Unix, ``time.sleep(0)`` always uses ``select()``, even if the
-      ``clock_nanosleep()`` or ``nanosleep()`` functions are available.
-
 .. index::
    single: % (percent); datetime format
 

Doc/whatsnew/3.14.rst

@@ -621,9 +621,8 @@ Two new events are added: :monitoring-event:`BRANCH_LEFT` and
 time
 ----
 
-* Ensure that :func:`time.sleep(0) <time.sleep>` does not accumulate delays on
-  POSIX platforms. The implementation always uses :manpage:`select(2)` even if
-  the :manpage:`clock_nanosleep` or :manpage:`nanosleep` functions are present.
+* Ensure that :func:`time.sleep(0) <time.sleep>` does not degrade over time
+  on non-Windows platforms.
   (Contributed by Bénédikt Tran in :gh:`125997`.)
 
 

Misc/NEWS.d/next/Library/2024-12-26-13-09-25.gh-issue-125997.Vsibep.rst

@@ -1,2 +1,2 @@
-Ensure that :func:`time.sleep(0) <time.sleep>` does not accumulate delays on
-non-Windows platforms. Patch by Bénédikt Tran.
+Ensure that :func:`time.sleep(0) <time.sleep>` does not degrade over time
+on non-Windows platforms. Patch by Bénédikt Tran.