diff -r fe532dccf8f6 Doc/library/timeit.rst --- a/Doc/library/timeit.rst Mon Apr 14 10:30:43 2014 -0400 +++ b/Doc/library/timeit.rst Mon Apr 14 12:38:25 2014 -0400 @@ -63,6 +63,12 @@ Create a :class:`Timer` instance with the given statement, *setup* code and *timer* function and run its :meth:`.timeit` method with *number* executions. + .. note:: + + Because :meth:`.timeit` is executing *stmt*, placing a return statement + in *stmt* will prevent :meth:`.timeit` from returning execution time. + It will instead return the data specified by your return statement. + .. function:: repeat(stmt='pass', setup='pass', timer=, repeat=3, number=1000000)