[issue43407] time.monotonic(): Docs imply comparing call N and call N+M is invalid for M>1

Change by Terry J. Reedy : -- resolution: -> fixed stage: patch review -> resolved status: open -> closed versions: +Python 3.10 -Python 3.6, Python 3.7 ___ Python tracker

[issue43407] time.monotonic(): Docs imply comparing call N and call N+M is invalid for M>1

miss-islington added the comment: New changeset 65f3a0d20c8198443c5c6cb44410114fe8c4bf4e by Miss Islington (bot) in branch '3.9': bpo-43407: Clarify comparisons of time.monotonic() et al results (GH-24757) https://github.com/python/cpython/commit/65f3a0d20c8198443c5c6cb44410114fe8c4bf4e

[issue43407] time.monotonic(): Docs imply comparing call N and call N+M is invalid for M>1

miss-islington added the comment: New changeset e12a9e2f62bea8ddc755e373f17adfbb2740b0b1 by Miss Islington (bot) in branch '3.8': bpo-43407: Clarify comparisons of time.monotonic() et al results (GH-24757) https://github.com/python/cpython/commit/e12a9e2f62bea8ddc755e373f17adfbb2740b0b1

[issue43407] time.monotonic(): Docs imply comparing call N and call N+M is invalid for M>1

Change by miss-islington : -- pull_requests: +23537 pull_request: https://github.com/python/cpython/pull/24769 ___ Python tracker ___

[issue43407] time.monotonic(): Docs imply comparing call N and call N+M is invalid for M>1

Change by miss-islington : -- nosy: +miss-islington nosy_count: 2.0 -> 3.0 pull_requests: +23536 pull_request: https://github.com/python/cpython/pull/24768 ___ Python tracker

[issue43407] time.monotonic(): Docs imply comparing call N and call N+M is invalid for M>1

Terry J. Reedy added the comment: New changeset ff5f05934db241dfafc604989b2de3487b09ca82 by Alex Willmer in branch 'master': bpo-43407: Clarify comparisons of time.monotonic() et al results (GH-24757) https://github.com/python/cpython/commit/ff5f05934db241dfafc604989b2de3487b09ca82

[issue43407] time.monotonic(): Docs imply comparing call N and call N+M is invalid for M>1

Change by Alex Willmer : -- keywords: +patch pull_requests: +23528 stage: -> patch review pull_request: https://github.com/python/cpython/pull/24757 ___ Python tracker ___

[issue43407] time.monotonic(): Docs imply comparing call N and call N+M is invalid for M>1

Alex Willmer added the comment: Discussion from #python IRC [21:51] Given `a=time.monotonic(); b=time.monotonic(); c=time.monotonic()` is `c-a < delta` a valid comparison? Until this evening I thought so, but I've just read https://docs.python.org/3/library/time.html#time.monotonic and

[issue43407] time.monotonic(): Docs imply comparing call N and call N+M is invalid for M>1

New submission from Alex Willmer : I believe the documentation for time.monotonic() and time.perf_counter() could be misleading. Taken literally they could imply that given delta = 0.1 a = time.monotonic() b = time.monotonic() c = time.monotonic() the comparisons `b - a < delta`, and `c - b