[Python-checkins] r87422 - in python/branches/release31-maint: Doc/library/platform.rst

[antoine.pitrou]

Author: antoine.pitrou
Date: Tue Dec 21 19:56:38 2010
New Revision: 87422

Log:
Merged revisions 87421 via svnmerge from 
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r87421 | antoine.pitrou | 2010-12-21 19:49:01 +0100 (mar., 21 déc. 2010) | 4 lines
  
  Suggest sys.maxsize as a reliable way to know whether the interpreter is 64-bit.
  (part of #10735)
........


Modified:
   python/branches/release31-maint/   (props changed)
   python/branches/release31-maint/Doc/library/platform.rst

Modified: python/branches/release31-maint/Doc/library/platform.rst
==============================================================================
--- python/branches/release31-maint/Doc/library/platform.rst	(original)
+++ python/branches/release31-maint/Doc/library/platform.rst	Tue Dec 21 19:56:38 2010
@@ -36,6 +36,16 @@
    and then only if the executable points to the Python interpreter.  Reasonable
    defaults are used when the above needs are not met.
 
+   .. note::
+
+      On Mac OS X (and perhaps other platforms), executable files may be
+      universal files containing multiple architectures.
+
+      To get at the "64-bitness" of the current interpreter, it is more
+      reliable to query the :attr:`sys.maxsize` attribute::
+
+         is_64bits = sys.maxsize > 2**32
+
 
 .. function:: machine()
 
@@ -186,7 +196,7 @@
 
    .. note::
 
-      Note: this function works best with Mark Hammond's
+      This function works best with Mark Hammond's
       :mod:`win32all` package installed, but also on Python 2.3 and
       later (support for this was added in Python 2.6). It obviously
       only runs on Win32 compatible platforms.