Apply suggestions from code review

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>

Author: 3 people

Doc/library/timeit.rst

@@ -73,7 +73,7 @@ The module defines three convenience functions and a public class:
    .. versionchanged:: 3.5
       The optional *globals* parameter was added.
 
-   .. versionchanged:: 3.8
+   .. versionchanged:: next
       The optional *target_time* parameter was added.
 
 
@@ -92,7 +92,7 @@ The module defines three convenience functions and a public class:
    .. versionchanged:: 3.7
       Default value of *repeat* changed from 3 to 5.
 
-   .. versionchanged:: 3.15
+   .. versionchanged:: next
       The optional *target_time* parameter was added.
 
 .. function:: default_timer()
@@ -130,7 +130,7 @@ The module defines three convenience functions and a public class:
    .. versionchanged:: 3.5
       The optional *globals* parameter was added.
 
-   .. versionchanged:: 3.8
+   .. versionchanged:: next
       The optional *target_time* parameter was added.
 
    .. method:: Timer.timeit(number=1000000)
@@ -250,11 +250,11 @@ Where the following options are understood:
 
    .. versionadded:: 3.5
 
-.. cmdoption:: -t, --target_time=T
+.. option:: -t, --target-time=T
 
     calls :meth:`.timeit` repeatedly so that the total time >= *target_time* seconds
 
-   .. versionadded:: 3.15
+   .. versionadded:: next
 
 .. cmdoption:: -v, --verbose
 

Lib/timeit.py

@@ -17,8 +17,8 @@
   -p/--process: use time.process_time() (default is time.perf_counter())
   -v/--verbose: print raw timing results; repeat for more digits precision
   -u/--unit: set the output time unit (nsec, usec, msec, or sec)
-  -t/--target_time T: if number is 0 the code will run until it
-                      takes *at least* ``target_time`` seconds
+  -t/--target-time T: if --number is 0 the code will run until it
+                      takes *at least* this many seconds
                       (default: 0.2)
   -h/--help: print this usage message and exit
   --: separate options from statement, use when statement starts with -
@@ -31,7 +31,7 @@
 
 If -n is not given, a suitable number of loops is calculated by trying
 increasing numbers from the sequence 1, 2, 5, 10, 20, 50, ... until the
-total time is at least target_time seconds.
+total time is at least --target-time seconds.
 
 Note: there is a certain baseline overhead associated with executing a
 pass statement.  It differs between versions.  The code here doesn't try
@@ -319,7 +319,7 @@ def main(args=None, *, _wrap_timer=None):
                 repeat = 1
         if o in ("-p", "--process"):
             timer = time.process_time
-        if o in ("-t", "--target_time"):
+        if o in ("-t", "--target-time"):
             target_time = float(a)
         if o in ("-v", "--verbose"):
             if verbose:

Misc/NEWS.d/next/Library/2019-04-25-21-11-37.bpo-36461.TO5YyP.rst

@@ -1,4 +1,4 @@
-In timeit module:
+:mod:`timeit`:
 - added a new parameter *target_time* to :func:`timeit.timeit` and
   :func:`timeit.repeat` methods and :class:`timeit.Timer` class;
 - had ``timeit`` and ``repeat`` methods (and functions) fall back