From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Sat, 24 Dec 2022 05:31:18 +0000 (-0800)
Subject: gh-77771: Add enterabs example in sched (GH-92716)
X-Git-Tag: v3.11.2~145
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=b914054d9de574f5b3489f8601482eac5a7699e0;p=thirdparty%2FPython%2Fcpython.git

gh-77771: Add enterabs example in sched (GH-92716)

(cherry picked from commit 0f6420640c0f3462e6b76b01a392844676de1fb9)

Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com>
Co-authored-by: Shantanu <12621235+hauntsaninja@users.noreply.github.com>
---

diff --git a/Doc/library/sched.rst b/Doc/library/sched.rst
index a4ba2848f11d..a051c65b97b0 100644
--- a/Doc/library/sched.rst
+++ b/Doc/library/sched.rst
@@ -44,16 +44,22 @@ Example::
    ...     print(time.time())
    ...     s.enter(10, 1, print_time)
    ...     s.enter(5, 2, print_time, argument=('positional',))
+   ...     # despite having higher priority, 'keyword' runs after 'positional' as enter() is relative
    ...     s.enter(5, 1, print_time, kwargs={'a': 'keyword'})
+   ...     s.enterabs(1_650_000_000, 10, print_time, argument=("first enterabs",))
+   ...     s.enterabs(1_650_000_000, 5, print_time, argument=("second enterabs",))
    ...     s.run()
    ...     print(time.time())
    ...
    >>> print_some_times()
-   930343690.257
-   From print_time 930343695.274 positional
-   From print_time 930343695.275 keyword
-   From print_time 930343700.273 default
-   930343700.276
+   1652342830.3640375
+   From print_time 1652342830.3642538 second enterabs
+   From print_time 1652342830.3643398 first enterabs
+   From print_time 1652342835.3694863 positional
+   From print_time 1652342835.3696074 keyword
+   From print_time 1652342840.369612 default
+   1652342840.3697174
+
 
 .. _scheduler-objects: