This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author chris.jerdonek
Recipients chris.jerdonek, docs@python, ezio.melotti, pitrou, rhettinger
Date 2012-10-02.01:36:37
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1349141797.93.0.213780736004.issue15979@psf.upfronthosting.co.za>
In-reply-to
Content
I copy-edited the patch just looking for minor things like punctuation, etc:

+a :ref:`command-line-interface` as well as :ref:`callable <python-interface>`

a callable one

+See also Tim Peters' introduction to the "Algorithms" chapter in the Python
+Cookbook, published by O'Reilly.

italicize or underline book titles (is there a reST directive for books?)

+The following example shows how the :ref:`command-line-interface`,

no comma

+Python interface

Python Interface

+   Create a :class:`Timer` instance with the given statement, setup code and timer
+   function and run its :meth:`.timeit` method with *number* executions.

stars around setup and timer like there is with *number*?

+   Create a :class:`Timer` instance with the given statement, setup code and timer
+   function and run its :meth:`.repeat` method with the given *repeat* count and

ditto

+   Define a default timer, in a platform specific manner. On Windows,

platform-specific

+   :func:`time.clock` has microsecond granularity but :func:`time.time`'s

granularity, but

+   granularity is 1/60th of a second; on Unix, :func:`time.clock` has 1/100th of

I would just split this into two sentences since it already combines two compound sentences (i.e. it is effectively four sentences):

second.  On Unix,

+   a second granularity and :func:`time.time` is much more precise.  On either

granularity, and

+   Time *number* executions of the main statement. This executes the setup

statement.  This

+   statement once, and then returns the time it takes to execute the main statement
+   a number of times, measured in seconds as a float.  The argument is the number

*number* times

+   baseline overhead can be measured by invoking the program without arguments and

arguments, and
History
Date User Action Args
2012-10-02 01:36:38chris.jerdoneksetrecipients: + chris.jerdonek, rhettinger, pitrou, ezio.melotti, docs@python
2012-10-02 01:36:37chris.jerdoneksetmessageid: <1349141797.93.0.213780736004.issue15979@psf.upfronthosting.co.za>
2012-10-02 01:36:37chris.jerdoneklinkissue15979 messages
2012-10-02 01:36:37chris.jerdonekcreate