From: Antoine Pitrou <solipsis@pitrou.net>
Date: Tue, 21 Dec 2010 18:49:01 +0000 (+0000)
Subject: Suggest sys.maxsize as a reliable way to know whether the interpreter is 64-bit.
X-Git-Tag: v3.2rc1~386
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=f259076790dac0b0c596a4545f05967d9cc76f65;p=python

Suggest sys.maxsize as a reliable way to know whether the interpreter is 64-bit.
(part of #10735)
---

diff --git a/Doc/library/platform.rst b/Doc/library/platform.rst
index 1fe103151b..ee0dc31d36 100644
--- a/Doc/library/platform.rst
+++ b/Doc/library/platform.rst
@@ -36,6 +36,16 @@ Cross Platform
    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 @@ Windows Platform
 
    .. 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.