Merge: closes issue 16643 (not ....2 as in last commit message)

Doc/library/sched.rst

@@ -14,12 +14,13 @@
 The :mod:`sched` module defines a class which implements a general purpose event
 scheduler:
 
-.. class:: scheduler(timefunc=time.time, delayfunc=time.sleep)
+.. class:: scheduler(timefunc=time.monotonic, delayfunc=time.sleep)
 
    The :class:`scheduler` class defines a generic interface to scheduling events.
    It needs two functions to actually deal with the "outside world" --- *timefunc*
    should be callable without arguments, and return  a number (the "time", in any
-   units whatsoever).  The *delayfunc* function should be callable with one
+   units whatsoever). If time.monotonic is not available, the *timefunc* default
+   is time.time instead. The *delayfunc* function should be callable with one
    argument, compatible with the output of *timefunc*, and should delay that many
    time units. *delayfunc* will also be called with the argument ``0`` after each
    event is run to allow other threads an opportunity to run in multi-threaded

Misc/ACKS

@@ -44,6 +44,7 @@ Jérémy Anger
 Ankur Ankan
 Jon Anglin
 Heidi Annexstad
+Ramchandra Apte
 Éric Araujo
 Alicia Arlen
 Jeffrey Armstrong

Misc/NEWS

@@ -1078,6 +1078,9 @@ Build
 Documentation
 -------------
 
+- Issue #16642: sched.scheduler timefunc initial default is time.monotonic.
+  Patch by Ramchandra Apte
+
 - Issue #15465: Document the versioning macros in the C API docs rather than
   the standard library docs. Patch by Kushal Das.