From: Bar Harel <bzvi7919@gmail.com>
Date: Mon, 18 Aug 2025 12:18:54 +0000 (+0100)
Subject: gh-127859: Fixed documentation for call_later and call_at for early wakeup in asyncio... 
X-Git-Tag: v3.15.0a1~658
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=92be979f64cbc12a32dc391d66caf4398fd24763;p=thirdparty%2FPython%2Fcpython.git

gh-127859: Fixed documentation for call_later and call_at for early wakeup in asyncio (#137859)
---

diff --git a/Doc/library/asyncio-eventloop.rst b/Doc/library/asyncio-eventloop.rst
index 9561c40776f0..0ccc7a2b4482 100644
--- a/Doc/library/asyncio-eventloop.rst
+++ b/Doc/library/asyncio-eventloop.rst
@@ -304,6 +304,12 @@ clocks to track time.
    custom :class:`contextvars.Context` for the *callback* to run in.
    The current context is used when no *context* is provided.
 
+   .. note::
+
+      For performance, callbacks scheduled with :meth:`loop.call_later`
+      may run up to one clock-resolution early (see
+      ``time.get_clock_info('monotonic').resolution``).
+
    .. versionchanged:: 3.7
       The *context* keyword-only parameter was added. See :pep:`567`
       for more details.
@@ -324,6 +330,12 @@ clocks to track time.
    An instance of :class:`asyncio.TimerHandle` is returned which can
    be used to cancel the callback.
 
+   .. note::
+
+      For performance, callbacks scheduled with :meth:`loop.call_at`
+      may run up to one clock-resolution early (see
+      ``time.get_clock_info('monotonic').resolution``).
+
    .. versionchanged:: 3.7
       The *context* keyword-only parameter was added. See :pep:`567`
       for more details.