From 47620a661128ce91f46f01fb46e1326880365e75 Mon Sep 17 00:00:00 2001 From: Victor Stinner Date: Sun, 29 Apr 2012 02:52:39 +0200 Subject: Close #14309: Deprecate time.clock() Use time.perf_counter() or time.process_time() instead. --- Doc/library/time.rst | 5 +++++ Doc/whatsnew/3.3.rst | 3 +++ Misc/NEWS | 3 +++ 3 files changed, 11 insertions(+) diff --git a/Doc/library/time.rst b/Doc/library/time.rst index 56ca865..879f8c7 100644 --- a/Doc/library/time.rst +++ b/Doc/library/time.rst @@ -136,6 +136,11 @@ The module defines the following functions and data items: :c:func:`QueryPerformanceCounter`. The resolution is typically better than one microsecond. + .. deprecated:: 3.3 + The behaviour of this function depends on the platform: use + :func:`perf_counter` or :func:`process_time` instead, depending on your + requirements, to have a well defined behaviour. + .. function:: clock_getres(clk_id) diff --git a/Doc/whatsnew/3.3.rst b/Doc/whatsnew/3.3.rst index 3d63127..c6708fe 100644 --- a/Doc/whatsnew/3.3.rst +++ b/Doc/whatsnew/3.3.rst @@ -1188,6 +1188,9 @@ Deprecated Python modules, functions and methods the ANSI code page anymore and to support any filename. * :issue:`13988`: The :mod:`xml.etree.cElementTree` module is deprecated. The accelerator is used automatically whenever available. +* The behaviour of :func:`time.clock` depends on the platform: use the new + :func:`time.perf_counter` or :func:`time.process_time` function instead, + depending on your requirements, to have a well defined behaviour. Deprecated functions and types of the C API diff --git a/Misc/NEWS b/Misc/NEWS index 995ec9e..3b5cbda 100644 --- a/Misc/NEWS +++ b/Misc/NEWS @@ -81,6 +81,9 @@ Core and Builtins Library ------- +- Issue #14309: Deprecate time.clock(), use time.perf_counter() or + time.process_time() instead. + - Issue #14428: Implement the PEP 418. Add time.get_clock_info(), time.perf_counter() and time.process_time() functions, and rename time.steady() to time.monotonic(). -- cgit v0.12