summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorVictor Stinner <victor.stinner@gmail.com>2012-04-29 00:52:39 (GMT)
committerVictor Stinner <victor.stinner@gmail.com>2012-04-29 00:52:39 (GMT)
commit47620a661128ce91f46f01fb46e1326880365e75 (patch)
tree0018249b44f8b8471e93a9ea0f8567352a0b651f
parentec89539ccccd6103665a7a5c7234cf09f27c1c72 (diff)
downloadcpython-47620a661128ce91f46f01fb46e1326880365e75.zip
cpython-47620a661128ce91f46f01fb46e1326880365e75.tar.gz
cpython-47620a661128ce91f46f01fb46e1326880365e75.tar.bz2
Close #14309: Deprecate time.clock()
Use time.perf_counter() or time.process_time() instead.
-rw-r--r--Doc/library/time.rst5
-rw-r--r--Doc/whatsnew/3.3.rst3
-rw-r--r--Misc/NEWS3
3 files changed, 11 insertions, 0 deletions
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().