[issue15979] Improve timeit documentation

2012-10-01 Thread Ezio Melotti
Ezio Melotti added the comment: Fixed, thanks for the review! -- resolution: -> fixed stage: commit review -> committed/rejected status: open -> closed versions: +Python 3.4 ___ Python tracker

[issue15979] Improve timeit documentation

2012-10-01 Thread Roundup Robot
Roundup Robot added the comment: New changeset 60c831305e73 by Ezio Melotti in branch '2.7': #15979: improve timeit documentation. http://hg.python.org/cpython/rev/60c831305e73 New changeset d5a4300702c1 by Ezio Melotti in branch '3.2': #15979: improve timeit documentation. http://hg.python.org/

[issue15979] Improve timeit documentation

2012-10-01 Thread Chris Jerdonek
Chris Jerdonek added the comment: I copy-edited the patch just looking for minor things like punctuation, etc: +a :ref:`command-line-interface` as well as :ref:`callable ` a callable one +See also Tim Peters' introduction to the "Algorithms" chapter in the Python +Cookbook, published by O'Reil

[issue15979] Improve timeit documentation

2012-10-01 Thread Ezio Melotti
Changes by Ezio Melotti : -- stage: patch review -> commit review Added file: http://bugs.python.org/file27382/issue15979-2.diff ___ Python tracker ___ __

[issue15979] Improve timeit documentation

2012-09-24 Thread Ezio Melotti
Ezio Melotti added the comment: The first example shows the basic usage and it's right at the beginning, all the other "advanced" examples are at the bottom. About the autocalibration you are right, I'll rephrase the sentence (see also #6422). -- _

[issue15979] Improve timeit documentation

2012-09-24 Thread Antoine Pitrou
Antoine Pitrou added the comment: I don't think there's a need for two separate examples sections (one "basic examples" and one "examples"). Also, you say a couple of times "The equivalent can be achieved from the :ref:`python-interface`", but that's not true since the command-line interface

[issue15979] Improve timeit documentation

2012-09-24 Thread Ezio Melotti
Ezio Melotti added the comment: Here's a patch. -- assignee: docs@python -> ezio.melotti keywords: +patch stage: needs patch -> patch review Added file: http://bugs.python.org/file27273/issue15979.diff ___ Python tracker

[issue15979] Improve timeit documentation

2012-09-19 Thread Ezio Melotti
Ezio Melotti added the comment: The sh syntax highlight can be enabled with: .. code-block:: sh $ ... -- ___ Python tracker ___ _

[issue15979] Improve timeit documentation

2012-09-19 Thread Raymond Hettinger
Raymond Hettinger added the comment: +1 -- nosy: +rhettinger ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: ht

[issue15979] Improve timeit documentation

2012-09-19 Thread Ezio Melotti
New submission from Ezio Melotti: The documentation of timeit can be improved in several ways: * it should start with a couple of short and comprehensible examples that show the basic usage from the command-line and from the code; * the 3 convenience functions should be moved before the class