Re: [Python-Dev] PEP 418 glossary

2012-04-13 Thread Antoine Pitrou
On Wed, 11 Apr 2012 02:49:41 -0400 Jim Jewett jimjjew...@gmail.com wrote: Accuracy: Is the answer correct? Any clock will eventually drift; if a clock is intended to match Civil Time, it will need to be adjusted back to the true time. You may also point to

Re: [Python-Dev] PEP 418 glossary

2012-04-13 Thread Victor Stinner
By the way, I hesitate to add a new mandatory key to time.get_clock_info() which indicates if the clock includes time elapsed during a sleep. Is is_realtime a good name for such flag? Examples: time.get_clock_info('time')['is_realtime'] == True time.get_clock_info('monotonic')['is_realtime'] ==

Re: [Python-Dev] PEP 418 glossary

2012-04-12 Thread Kristján Valur Jónsson
-Original Message- From: python-dev-bounces+kristjan=ccpgames@python.org [mailto:python-dev-bounces+kristjan=ccpgames@python.org] On Behalf Of Victor Stinner Sent: 11. apríl 2012 23:10 I integrated a simplified version of your Glossary into the PEP. Some changes: * a

Re: [Python-Dev] PEP 418 glossary

2012-04-12 Thread R. David Murray
On Thu, 12 Apr 2012 13:49:43 -, =?utf-8?B?S3Jpc3Rqw6FuIFZhbHVyIErDs25zc29u?= krist...@ccpgames.com wrote: Wallclock: This definition is wrong no metter how the BDFL feels about the word. Please see http://en.wikipedia.org/wiki/Wall_clock_time. I agree with the BDFL. I have always heard

[Python-Dev] PEP 418 glossary

2012-04-11 Thread Jim Jewett
I believe PEP 418 (or at least the discussion) would benefit greatly from a glossary to encourage people to use the same definitions. This is arguably the Definitions section, but it should move either near the end or (preferably) ahead of the Functions. It also needs to be greatly expanded.

Re: [Python-Dev] PEP 418 glossary

2012-04-11 Thread Chris Angelico
On Wed, Apr 11, 2012 at 4:49 PM, Jim Jewett jimjjew...@gmail.com wrote: Clock:    An instrument for measuring time.  Different clocks have different characteristics; for example, a clock with nanonsecond precision Small typo. Otherwise, excellent reference document - thank you! Well worth

Re: [Python-Dev] PEP 418 glossary

2012-04-11 Thread Stephen J. Turnbull
A few comments, YMMV. On Wed, Apr 11, 2012 at 3:49 PM, Jim Jewett jimjjew...@gmail.com wrote: Here is my strawman proposal, which does use slightly different definitions than the current PEP even for some terms that the PEP does define: Accuracy:    Is the answer correct?  Any clock will

Re: [Python-Dev] PEP 418 glossary

2012-04-11 Thread Nick Coghlan
On Wed, Apr 11, 2012 at 7:30 PM, Stephen J. Turnbull step...@xemacs.org wrote: Clock_Monotonic:    The characteristics expected of a monotonic clock in practice. Whose practice?  In C++, monotonic was defined as mathematically monotonic, and rather than talk about what's expected of a

Re: [Python-Dev] PEP 418 glossary

2012-04-11 Thread Raymond Hettinger
On Apr 11, 2012, at 2:49 AM, Jim Jewett wrote: I believe PEP 418 (or at least the discussion) would benefit greatly from a glossary to encourage people to use the same definitions. This sort of information is a good candidate for the HOW-TO section of the docs.

Re: [Python-Dev] PEP 418 glossary

2012-04-11 Thread Victor Stinner
2012/4/11 Jim Jewett jimjjew...@gmail.com: I believe PEP 418 (or at least the discussion) would benefit greatly from a glossary to encourage people to use the same definitions.  This is arguably the Definitions section, but it should move either near the end or (preferably) ahead of the