Mailman 3 March 2012 - Python-checkins

cpython (2.7): add 'safari' to webbrowser browsers table; thanks to Jonathan Eunice from docs@
by sandro.tosi March 31, 2012

March 31, 2012

http://hg.python.org/cpython/rev/9411b7268cf5 changeset: 76012:9411b7268cf5 branch: 2.7 parent: 76008:7c61fe5b4640 user: Sandro Tosi <sandro.tosi(a)gmail.com> date: Sat Mar 31 17:22:47 2012 +0200 summary: add 'safari' to webbrowser browsers table; thanks to Jonathan Eunice from docs@ files: Doc/library/webbrowser.rst | 2 ++ 1 files changed, 2 insertions(+), 0 deletions(-) diff --git a/Doc/library/webbrowser.rst b/Doc/library/webbrowser.rst --- a/Doc/library/webbrowser.rst +++ b/Doc/library/webbrowser.rst @@ -142,6 +142,8 @@ +-----------------------+-----------------------------------------+-------+ | ``'macosx'`` | :class:`MacOSX('default')` | \(4) | +-----------------------+-----------------------------------------+-------+ +| ``'safari'`` | :class:`MacOSX('safari')` | \(4) | ++-----------------------+-----------------------------------------+-------+ Notes: -- Repository URL: http://hg.python.org/cpython

1 0

cpython (3.2): add 'safari' to webbrowser browsers table; thanks to Jonathan Eunice from docs@
by sandro.tosi March 31, 2012

March 31, 2012

http://hg.python.org/cpython/rev/722ce1be9eeb changeset: 76013:722ce1be9eeb branch: 3.2 parent: 76006:ba32b8c7f5be user: Sandro Tosi <sandro.tosi(a)gmail.com> date: Sat Mar 31 17:23:10 2012 +0200 summary: add 'safari' to webbrowser browsers table; thanks to Jonathan Eunice from docs@ files: Doc/library/webbrowser.rst | 2 ++ 1 files changed, 2 insertions(+), 0 deletions(-) diff --git a/Doc/library/webbrowser.rst b/Doc/library/webbrowser.rst --- a/Doc/library/webbrowser.rst +++ b/Doc/library/webbrowser.rst @@ -137,6 +137,8 @@ +-----------------------+-----------------------------------------+-------+ | ``'macosx'`` | :class:`MacOSX('default')` | \(4) | +-----------------------+-----------------------------------------+-------+ +| ``'safari'`` | :class:`MacOSX('safari')` | \(4) | ++-----------------------+-----------------------------------------+-------+ Notes: -- Repository URL: http://hg.python.org/cpython

1 0

cpython: Fix warning when compiling socketmodule.c with VS2010
by kristjan.jonsson March 31, 2012

March 31, 2012

http://hg.python.org/cpython/rev/e46013f92013 changeset: 76011:e46013f92013 user: Kristján Valur Jónsson <kristjan(a)ccpgames.com> date: Sat Mar 31 13:35:00 2012 +0000 summary: Fix warning when compiling socketmodule.c with VS2010 VS2010 defineds the old errno constants in addition to the WSA* ones. files: Modules/socketmodule.c | 1 + 1 files changed, 1 insertions(+), 0 deletions(-) diff --git a/Modules/socketmodule.c b/Modules/socketmodule.c --- a/Modules/socketmodule.c +++ b/Modules/socketmodule.c @@ -390,6 +390,7 @@ #endif #ifdef MS_WIN32 +#undef EAFNOSUPPORT #define EAFNOSUPPORT WSAEAFNOSUPPORT #define snprintf _snprintf #endif -- Repository URL: http://hg.python.org/cpython

1 0

cpython: issue #3035: update PendingDeprecationWarning to DeprectionWarning, point
by andrew.svetlov March 31, 2012

March 31, 2012

http://hg.python.org/cpython/rev/2bc374182ed4 changeset: 76009:2bc374182ed4 parent: 76007:ec99fd5b5e60 user: Andrew Svetlov <andrew.svetlov(a)gmail.com> date: Sat Mar 31 14:55:55 2012 +0300 summary: issue #3035: update PendingDeprecationWarning to DeprectionWarning, point deprecation in tkinter doc files: Doc/library/tkinter.rst | 21 +++++++++++++++------ Lib/tkinter/__init__.py | 20 ++++++++++---------- 2 files changed, 25 insertions(+), 16 deletions(-) diff --git a/Doc/library/tkinter.rst b/Doc/library/tkinter.rst --- a/Doc/library/tkinter.rst +++ b/Doc/library/tkinter.rst @@ -735,22 +735,32 @@ displayed. You can use these :mod:`tkinter` functions to access these special points in text widgets: - AtEnd() +.. function:: AtEnd() refers to the last position in the text - AtInsert() + .. deprecated:: 3.3 + +.. function:: AtInsert() refers to the point where the text cursor is - AtSelFirst() + .. deprecated:: 3.3 + +.. function:: AtSelFirst() indicates the beginning point of the selected text - AtSelLast() + .. deprecated:: 3.3 + +.. function:: AtSelLast() denotes the last point of the selected text and finally - At(x[, y]) + .. deprecated:: 3.3 + +.. function:: At(x[, y]) refers to the character at pixel location *x*, *y* (with *y* not used in the case of a text entry widget, which contains a single line of text). + .. deprecated:: 3.3 + Text widget indexes The index notation for Text widgets is very rich and is best described in the Tk man pages. @@ -798,4 +808,3 @@ reference to the image. When the last Python reference to the image object is deleted, the image data is deleted as well, and Tk will display an empty box wherever the image was used. - diff --git a/Lib/tkinter/__init__.py b/Lib/tkinter/__init__.py --- a/Lib/tkinter/__init__.py +++ b/Lib/tkinter/__init__.py @@ -2126,14 +2126,14 @@ # Indices: # XXX I don't like these -- take them away def AtEnd(): - warnings.warn("tkinter.AtEnd will be removed in 3.5", - PendingDeprecationWarning, stacklevel=2) + warnings.warn("tkinter.AtEnd will be removed in 3.4", + DeprecationWarning, stacklevel=2) return 'end' def AtInsert(*args): - warnings.warn("tkinter.AtInsert will be removed in 3.5", - PendingDeprecationWarning, stacklevel=2) + warnings.warn("tkinter.AtInsert will be removed in 3.4", + DeprecationWarning, stacklevel=2) s = 'insert' for a in args: if a: s = s + (' ' + a) @@ -2141,20 +2141,20 @@ def AtSelFirst(): - warnings.warn("tkinter.AtSelFirst will be removed in 3.5", - PendingDeprecationWarning, stacklevel=2) + warnings.warn("tkinter.AtSelFirst will be removed in 3.4", + DeprecationWarning, stacklevel=2) return 'sel.first' def AtSelLast(): - warnings.warn("tkinter.AtSelLast will be removed in 3.5", - PendingDeprecationWarning, stacklevel=2) + warnings.warn("tkinter.AtSelLast will be removed in 3.4", + DeprecationWarning, stacklevel=2) return 'sel.last' def At(x, y=None): - warnings.warn("tkinter.At will be removed in 3.5", - PendingDeprecationWarning, stacklevel=2) + warnings.warn("tkinter.At will be removed in 3.4", + DeprecationWarning, stacklevel=2) if y is None: return '@%r' % (x,) else: -- Repository URL: http://hg.python.org/cpython

1 0

cpython (2.7): update NEWS for 2.7 as Terry Reedy proposed
by andrew.svetlov March 31, 2012

March 31, 2012

http://hg.python.org/cpython/rev/7c61fe5b4640 changeset: 76008:7c61fe5b4640 branch: 2.7 parent: 76001:cb5214e6c287 user: Andrew Svetlov <andrew.svetlov(a)gmail.com> date: Sat Mar 31 14:34:16 2012 +0300 summary: update NEWS for 2.7 as Terry Reedy proposed files: Lib/idlelib/NEWS.txt | 6 ++++-- Misc/NEWS | 6 ++++-- 2 files changed, 8 insertions(+), 4 deletions(-) diff --git a/Lib/idlelib/NEWS.txt b/Lib/idlelib/NEWS.txt --- a/Lib/idlelib/NEWS.txt +++ b/Lib/idlelib/NEWS.txt @@ -1,8 +1,10 @@ What's New in IDLE 2.7.3? ======================= -- Issue #14409: IDLE doesn't not execute commands from shell, - error with default keybinding for Return. (Patch by Roger Serwy) +- Issue #14409: IDLE now properly executes commands in the Shell window + when it cannot read the normal config files on startup and + has to use the built-in default key bindings. + There was previously a bug in one of the defaults. - Issue #3573: IDLE hangs when passing invalid command line args (directory(ies) instead of file(s)). diff --git a/Misc/NEWS b/Misc/NEWS --- a/Misc/NEWS +++ b/Misc/NEWS @@ -35,8 +35,10 @@ Library ------- -- Issue #14409: IDLE doesn't not execute commands from shell, - error with default keybinding for Return. (Patch by Roger Serwy) +- Issue #14409: IDLE now properly executes commands in the Shell window + when it cannot read the normal config files on startup and + has to use the built-in default key bindings. + There was previously a bug in one of the defaults. - Issue #10340: asyncore - properly handle EINVAL in dispatcher constructor on OSX; avoid to call handle_connect in case of a disconnected socket which -- Repository URL: http://hg.python.org/cpython

1 0

cpython (merge 3.2 -> default): Merge from 3.2
by andrew.svetlov March 31, 2012

March 31, 2012

http://hg.python.org/cpython/rev/ec99fd5b5e60 changeset: 76007:ec99fd5b5e60 parent: 76005:5b3a44f22470 parent: 76006:ba32b8c7f5be user: Andrew Svetlov <andrew.svetlov(a)gmail.com> date: Sat Mar 31 14:20:19 2012 +0300 summary: Merge from 3.2 files: Lib/idlelib/NEWS.txt | 6 ++++-- Misc/NEWS | 6 ++++-- 2 files changed, 8 insertions(+), 4 deletions(-) diff --git a/Lib/idlelib/NEWS.txt b/Lib/idlelib/NEWS.txt --- a/Lib/idlelib/NEWS.txt +++ b/Lib/idlelib/NEWS.txt @@ -3,8 +3,10 @@ - IDLE can be launched as `python -m idlelib` -- Issue #14409: IDLE doesn't not execute commands from shell, - error with default keybinding for Return. (Patch by Roger Serwy) +- Issue #14409: IDLE now properly executes commands in the Shell window + when it cannot read the normal config files on startup and + has to use the built-in default key bindings. + There was previously a bug in one of the defaults. - Issue #3573: IDLE hangs when passing invalid command line args (directory(ies) instead of file(s)). diff --git a/Misc/NEWS b/Misc/NEWS --- a/Misc/NEWS +++ b/Misc/NEWS @@ -34,8 +34,10 @@ Library ------- -- Issue #14409: IDLE doesn't not execute commands from shell, - error with default keybinding for Return. (Patch by Roger Serwy) +- Issue #14409: IDLE now properly executes commands in the Shell window + when it cannot read the normal config files on startup and + has to use the built-in default key bindings. + There was previously a bug in one of the defaults. - Issue #14416: syslog now defines the LOG_ODELAY and LOG_AUTHPRIV constants if they are defined in <syslog.h>. -- Repository URL: http://hg.python.org/cpython

1 0

cpython (3.2): update NEWS as Terry Reedy proposed
by andrew.svetlov March 31, 2012

March 31, 2012

http://hg.python.org/cpython/rev/ba32b8c7f5be changeset: 76006:ba32b8c7f5be branch: 3.2 parent: 75999:dee1597b3ce3 user: Andrew Svetlov <andrew.svetlov(a)gmail.com> date: Sat Mar 31 14:10:10 2012 +0300 summary: update NEWS as Terry Reedy proposed files: Lib/idlelib/NEWS.txt | 6 ++++-- Misc/NEWS | 6 ++++-- 2 files changed, 8 insertions(+), 4 deletions(-) diff --git a/Lib/idlelib/NEWS.txt b/Lib/idlelib/NEWS.txt --- a/Lib/idlelib/NEWS.txt +++ b/Lib/idlelib/NEWS.txt @@ -1,8 +1,10 @@ What's New in IDLE 3.2.3? ========================= -- Issue #14409: IDLE doesn't not execute commands from shell, - error with default keybinding for Return. (Patch by Roger Serwy) +- Issue #14409: IDLE now properly executes commands in the Shell window + when it cannot read the normal config files on startup and + has to use the built-in default key bindings. + There was previously a bug in one of the defaults. - Issue #3573: IDLE hangs when passing invalid command line args (directory(ies) instead of file(s)). diff --git a/Misc/NEWS b/Misc/NEWS --- a/Misc/NEWS +++ b/Misc/NEWS @@ -31,8 +31,10 @@ Library ------- -- Issue #14409: IDLE doesn't not execute commands from shell, - error with default keybinding for Return. (Patch by Roger Serwy) +- Issue #14409: IDLE now properly executes commands in the Shell window + when it cannot read the normal config files on startup and + has to use the built-in default key bindings. + There was previously a bug in one of the defaults. - Issue #10340: asyncore - properly handle EINVAL in dispatcher constructor on OSX; avoid to call handle_connect in case of a disconnected socket which -- Repository URL: http://hg.python.org/cpython

1 0

cpython: Fix the tests of GC collection in ET.Element according to Benjamin's
by eli.bendersky March 31, 2012

March 31, 2012

http://hg.python.org/cpython/rev/5b3a44f22470 changeset: 76005:5b3a44f22470 user: Eli Bendersky <eliben(a)gmail.com> date: Sat Mar 31 13:55:38 2012 +0300 summary: Fix the tests of GC collection in ET.Element according to Benjamin's recommendations files: Lib/test/test_xml_etree.py | 40 ++++++++++++------------- 1 files changed, 19 insertions(+), 21 deletions(-) diff --git a/Lib/test/test_xml_etree.py b/Lib/test/test_xml_etree.py --- a/Lib/test/test_xml_etree.py +++ b/Lib/test/test_xml_etree.py @@ -14,14 +14,14 @@ # Don't re-import "xml.etree.ElementTree" module in the docstring, # except if the test is specific to the Python implementation. -import gc import html import io import sys import unittest +import weakref from test import support -from test.support import findfile, import_fresh_module +from test.support import findfile, import_fresh_module, gc_collect pyET = import_fresh_module('xml.etree.ElementTree', blocked=['_elementtree']) @@ -1848,28 +1848,26 @@ self.assertRaises(TypeError, e.insert, 0, 'foo') def test_cyclic_gc(self): - class ShowGC: - def __init__(self, flaglist): - self.flaglist = flaglist - def __del__(self): - self.flaglist.append(1) + class Dummy: + pass - # Test the shortest cycle: lst->element->lst - fl = [] - lst = [ShowGC(fl)] - lst.append(ET.Element('joe', attr=lst)) - del lst - gc.collect() - self.assertEqual(fl, [1]) + # Test the shortest cycle: d->element->d + d = Dummy() + d.dummyref = ET.Element('joe', attr=d) + wref = weakref.ref(d) + del d + gc_collect() + self.assertIsNone(wref()) - # A longer cycle: lst->e->e2->lst - fl = [] + # A longer cycle: d->e->e2->d e = ET.Element('joe') - lst = [ShowGC(fl), e] - e2 = ET.SubElement(e, 'foo', attr=lst) - del lst, e, e2 - gc.collect() - self.assertEqual(fl, [1]) + d = Dummy() + d.dummyref = e + wref = weakref.ref(d) + e2 = ET.SubElement(e, 'foo', attr=d) + del d, e, e2 + gc_collect() + self.assertIsNone(wref()) class ElementTreeTest(unittest.TestCase): -- Repository URL: http://hg.python.org/cpython

1 0

cpython: Fix-up a comment
by raymond.hettinger March 31, 2012

March 31, 2012

http://hg.python.org/cpython/rev/1c22c1109824 changeset: 76004:1c22c1109824 user: Raymond Hettinger <python(a)rcn.com> date: Sat Mar 31 02:19:06 2012 -0700 summary: Fix-up a comment files: Lib/functools.py | 5 ++--- 1 files changed, 2 insertions(+), 3 deletions(-) diff --git a/Lib/functools.py b/Lib/functools.py --- a/Lib/functools.py +++ b/Lib/functools.py @@ -172,7 +172,7 @@ cache = {} hits = misses = 0 kwd_mark = (object(),) # separate positional and keyword args - cache_get = cache.get # bound method to lookup key or return None + cache_get = cache.get # bound method to lookup a key or return None sentinel = object() # unique object used with cache_get _len = len # localize the global len() function lock = Lock() # because linkedlist updates aren't threadsafe @@ -250,8 +250,7 @@ # empty the oldest link and make it the new root root = root[NEXT] del cache[root[KEY]] - root[KEY] = None - root[RESULT] = None + root[KEY] = root[RESULT] = None misses += 1 return result -- Repository URL: http://hg.python.org/cpython

1 0

peps: PEP 418: more grammar fixes
by georg.brandl March 31, 2012

March 31, 2012

http://hg.python.org/peps/rev/39c8c00a854d changeset: 4180:39c8c00a854d user: Georg Brandl <georg(a)python.org> date: Sat Mar 31 08:53:07 2012 +0200 summary: PEP 418: more grammar fixes files: pep-0418.txt | 101 ++++++++++++++++++++------------------ 1 files changed, 54 insertions(+), 47 deletions(-) diff --git a/pep-0418.txt b/pep-0418.txt --- a/pep-0418.txt +++ b/pep-0418.txt @@ -23,20 +23,22 @@ Use cases: * Display the current time to a human (e.g. display a calendar or draw - a wall clock): use system clock. time.time() or - datetime.datetime.now() -* Benchmark, profiling, timeout: time.highres() -* Event scheduler: time.monotonic(), or time.monotonic(fallback=False) + a wall clock): use system clock, i.e. time.time() or + datetime.datetime.now(). +* Benchmark, profiling, timeout: time.highres(). +* Event scheduler: time.monotonic(), or time.monotonic(fallback=False). Functions ========= -* time.time(): system clock, "wall clock" -* time.highres(): clock with the best accuracy +To fulfill the use cases, the functions' properties are: + +* time.time(): system clock, "wall clock". +* time.highres(): clock with the best accuracy. * time.monotonic(fallback=True): monotonic clock. If no monotonic clock is available, falls back to system clock by default, or raises - an OSError if *fallback* is False. time.monotonic(fallback=True) + an OSError if *fallback* is False. time.monotonic(fallback=True) cannot go backward. @@ -45,7 +47,7 @@ The system time is the "wall clock". It can be set manually by the system administrator or automatically by a NTP daemon. It can jump -backward and forward. It is not monotonic. +backward and forward. It is not monotonic. It is available on all platforms and cannot fail. @@ -90,10 +92,10 @@ available or if the monotonic clock failed, and so it cannot fail. If fallback is False, it raises OSError if the monotonic clock failed and NotImplementedError if the platform does not provide a monotonic clock -(ex: GNU/Hurd). +(e.g. on GNU/Hurd). The elapsed time may or may not include time the system spends in -sleep or hibernation, it depends on the operating system. +sleep or hibernation; this depends on the operating system. Pseudo-code [#pseudo]_:: @@ -165,17 +167,17 @@ raise NotImplementedError("you platform does not provide any monotonic clock") return time.time() -On Windows, QueryPerformanceCounter() is not used even if it has a +On Windows, QueryPerformanceCounter() is not used even though it has a better resolution than GetTickCount(). It is not reliable and has too -much issues. +many issues. .. note:: time.monotonic() detects GetTickCount() integer overflow (32 bits, roll-over after 49.7 days): it increases a delta by 2\ :sup:`32` each time than an overflow is detected. The delta is stored in the - process local state and so time.monotonic() value may be different - in two Python processes. + process-local state and so the value of time.monotonic() may be + different in two Python processes. time.highres() @@ -250,11 +252,11 @@ mach_timebase_info() gives a fraction to convert the clock value to a number of nanoseconds. According to the documentation (`Technical Q&A QA1398 <https://developer.apple.com/library/mac/#qa/qa1398/>`_), -mach_timebase_info() is always equals to one and does never fail, even +mach_timebase_info() is always equal to one and never fails, even if the function may fail according to its prototype. -mach_absolute_time() stops during a sleep on PowerPC CPU, but not on -Intel CPU: `Different behaviour of mach_absolute_time() on i386 / ppc +mach_absolute_time() stops during a sleep on a PowerPC CPU, but not on +an Intel CPU: `Different behaviour of mach_absolute_time() on i386/ppc <http://lists.apple.com/archives/PerfOptimization-dev/2006/Jul/msg00024.html>`_. mach_absolute_time() has a resolution of 1 nanosecond. @@ -262,8 +264,8 @@ CLOCK_MONOTONIC, CLOCK_MONOTONIC_RAW ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -CLOCK_MONOTONIC and CLOCK_MONOTONIC_RAW represents monotonic time -since some unspecified starting point. They cannot be set. +CLOCK_MONOTONIC and CLOCK_MONOTONIC_RAW represent monotonic time since +some unspecified starting point. They cannot be set. Documentation: refer to the manual page of your operating system. Examples: @@ -291,22 +293,23 @@ is not subject to NTP adjustments. CLOCK_MONOTONIC_RAW requires Linux 2.6.28 or later. -On Linux, NTP may adjust CLOCK_MONOTONIC rate, but not jump backward. -If available, CLOCK_MONOTONIC_RAW should be used instead of +On Linux, NTP may adjust the CLOCK_MONOTONIC rate, but it cannot jump +backward. If available, CLOCK_MONOTONIC_RAW should be used instead of CLOCK_MONOTONIC to avoid the NTP adjustment. CLOCK_MONOTONIC stops while the machine is suspended. clock_gettime() fails if the system does not support the specified -clock, whereas the standard C library supports it. For example, +clock, even if the standard C library supports it. For example, CLOCK_MONOTONIC_RAW requires a kernel version 2.6.28 or later. clock_getres() gives the clock resolution. It is 1 nanosecond on Linux. .. note:: - clock_gettime() requires to link the program to the rt (real-time) - library. + + clock_gettime() requires to link the program against the rt + (real-time) library. Windows: QueryPerformanceCounter @@ -315,7 +318,7 @@ High-resolution performance counter. It is monotonic. QueryPerformanceFrequency() gives its frequency. -It has much higher resolution, but has lower long term accuracy than +It has a much higher resolution, but has lower long term accuracy than GetTickCount() and timeGetTime() clocks. For example, it will drift compared to the low precision clocks. @@ -330,9 +333,9 @@ * Windows XP: RDTSC instruction of Intel processors, the clock frequency is the frequency of the processor (between 200 MHz and 3 - GHz, usually greater than 1 GHz nowadays) -* Windows 2000: ACPI power management timer, frequency = 3,549,545 - Hz. It can be forced through the "/usepmtimer" flag in boot.ini + GHz, usually greater than 1 GHz nowadays). +* Windows 2000: ACPI power management timer, frequency = 3,549,545 Hz. + It can be forced through the "/usepmtimer" flag in boot.ini. .. * Windows 95/98: 8245 PIT chipset, frequency = 1,193,181 Hz @@ -344,12 +347,12 @@ QueryPerformanceCounter() cannot be adjusted: `SetSystemTimeAdjustment() <http://msdn.microsoft.com/en-us/library/windows/desktop/ms724943(v=vs.85).a…>`_ -does only adjust the system time. +only adjusts the system time. Bugs: * The performance counter value may unexpectedly leap forward because - of a hardware bug, see the `KB274323`_. + of a hardware bug, see `KB274323`_. * On VirtualBox, QueryPerformanceCounter() does not increment the high part every time the low part overflows, see `Monotonic timers <http://code-factor.blogspot.fr/2009/11/monotonic-timers.html>`_ @@ -375,13 +378,13 @@ `GetTickCount64() <http://msdn.microsoft.com/en-us/library/windows/desktop/ms724411(v=vs.85).a…>`_. -The elapsed time retrieved by GetTickCount or GetTickCount64 includes -time the system spends in sleep or hibernation. +The elapsed time retrieved by GetTickCount() or GetTickCount64() +includes time the system spends in sleep or hibernation. GetTickCount64() was added to Windows Vista and Windows Server 2008. The clock resolution is 1 millisecond. Its accuracy is usually around -15 ms. It is possible to improve the accuracy using the `undocumented +15 ms. It is possible to improve the accuracy using the `undocumented NtSetTimerResolution() function <http://undocumented.ntinternals.net/UserMode/Undocumented%20Functions/Time/…>`_. There are applications using this undocumented function, example: @@ -392,7 +395,7 @@ ^^^^^^^^^^^^^^^^^^^^ The timeGetTime function retrieves the system time, in milliseconds. -The system time is the time elapsed since Windows was started. Read +The system time is the time elapsed since Windows was started. Read the `timeGetTime() documentation <http://msdn.microsoft.com/en-us/library/windows/desktop/dd757629(v=vs.85).a…>`_. @@ -408,15 +411,16 @@ consumption. .. note:: + timeGetTime() and timeBeginPeriod() are part the Windows multimedia - library and so require to link the program with winmm or to load - dynamically the library. + library and so require to link the program against winmm or to + dynamically load the library. Solaris: CLOCK_HIGHRES ^^^^^^^^^^^^^^^^^^^^^^ -The Solaris OS has an CLOCK_HIGHRES timer that attempts to use an +The Solaris OS has a CLOCK_HIGHRES timer that attempts to use an optimal hardware source, and may give close to nanosecond resolution. CLOCK_HIGHRES is the nonadjustable, high-resolution clock. For timers created with a clockid_t value of CLOCK_HIGHRES, the system will @@ -468,7 +472,7 @@ The system time resolution can be read using GetSystemTimeAdjustment(). The accuracy is usually between 1 -millisecond and 15 milliseconds. Resolution: +millisecond and 15 milliseconds. Resolution: * GetSystemTimeAsFileTime(): 100 nanoseconds * ftime(): 1 millisecond @@ -508,7 +512,7 @@ * clock(): * Windows: The elapsed wall-clock time since the start of the - process (elapsed time in seconds times CLOCKS_PER_SEC). It can + process (elapsed time in seconds times CLOCKS_PER_SEC). It can fail. * UNIX: returns an approximation of processor time used by the program. @@ -519,10 +523,11 @@ Resolution: * clock() rate is CLOCKS_PER_SEC. It was called CLK_TCK in Microsoft - C before 6.0. On Linux 3, clock() has a resolution of 1 microsecond + C before 6.0. On Linux 3, clock() has a resolution of 1 + microsecond. * The clock resolution can be read using clock_getres(). - clock_getres(CLOCK_REALTIME) is 1 nanosecond on Linux -* GetProcessTimes(): call GetSystemTimeAdjustment() + clock_getres(CLOCK_REALTIME) is 1 nanosecond on Linux. +* GetProcessTimes(): call GetSystemTimeAdjustment(). Thread ^^^^^^ @@ -553,14 +558,16 @@ QueryUnbiasedInterruptTime() was introduced in Windows 7. + Linux timers ------------ There were 4 implementations of the time in the Linux kernel: UTIME -(1996), timer wheel (1997), HRT (2001) and hrtimers (2007). The later -is the result of the "high-res-timers" project started by George -Anzinger in 2001, contributed by Thomas Gleixner and Douglas Niehaus. -hrtimers implementation was merged into Linux 2.6.21 released in 2007. +(1996), timer wheel (1997), HRT (2001) and hrtimers (2007). The +latter is the result of the "high-res-timers" project started by +George Anzinger in 2001, with contributions by Thomas Gleixner and +Douglas Niehaus. hrtimers implementation was merged into Linux +2.6.21, released in 2007. hrtimers supports various clock sources. It sets a priority to each source to decide which one will be used. @@ -642,7 +649,7 @@ * Virtual machines provide less reliable clocks. * QueryPerformanceCounter() has known bugs (only one is not fixed yet) -Python may only workaround a specific known operating system bug: +Python may only work around a specific known operating system bug: `KB274323`_ contains a code example to workaround the bug (use GetTickCount() to detect QueryPerformanceCounter() leap). -- Repository URL: http://hg.python.org/peps

1 0