Close #14309: Deprecate time.clock()

vstinner · vstinner · commit 47620a661128 · 2012-04-29T02:52:39.000+02:00
Use time.perf_counter() or time.process_time() instead.
diff --git 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
@@ -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
@@ -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().
