Added support for handling MacOS platform information in ``.egg``

filenames, based on a contribution by Kevin Dangoor.  (NOTE: this may make
eggs compiled for OS X with older versions of setuptools unusable!  If you
have eggs whose file/directory names end with ``-darwin-*.egg``, you will
probably need to rename them to ``-macosx-*.egg``, substituting your
current Mac OS version for the darwin kernel version in the version number.
Or, you can just delete and reinstall the problematic eggs.)

--HG--
branch : setuptools
extra : convert_revision : svn%3A6015fed2-1504-0410-9fe1-9d1591cc4771/sandbox/trunk/setuptools%4041141

1 files changed, 35 insertions, 0 deletions

diff --git a/api_tests.txt b/api_tests.txt
index 0c39bcd7..414f6d6a 100755
--- a/api_tests.txt
+++ b/api_tests.txt
@@ -245,3 +245,38 @@ And adding a callback more than once has no effect, either::
     >>> ws.add(Distribution(project_name="JustATest", version="0.99"))
     Added JustATest 0.99
 
+
+Platform Compatibility Rules
+----------------------------
+
+On the Mac, there are potential compatibility issues for modules compiled
+on newer versions of Mac OS X than what the user is running. Additionally,
+Mac OS X will soon have two platforms to contend with: Intel and PowerPC.
+
+Basic equality works as on other platforms::
+
+    >>> from pkg_resources import compatible_platforms as cp
+    >>> reqd = 'macosx-10.4.2-Power_Macintosh'
+    >>> cp(reqd, reqd)
+    True
+    >>> cp("win32", reqd)
+    False
+
+Distributions made on other machine types are not compatible::
+
+    >>> cp("macosx-10.4.2-Intel", reqd)
+    False
+
+Distributions made on earlier versions of the OS are compatible, as
+long as they are from the same top-level version. The patchlevel version
+number does not matter::
+
+    >>> cp("macosx-10.4.5-Power_Macintosh", reqd)
+    True
+    >>> cp("macosx-10.3.5-Power_Macintosh", reqd)
+    True
+    >>> cp("macosx-10.5.5-Power_Macintosh", reqd)
+    False
+    >>> cp("macosx-9.5.5-Power_Macintosh", reqd)
+    False
+