Skip to content

Commit 761f6bd

Browse files
konstinwebknjaz
authored andcommitted
Document macosx_0_{y}_{arch} pattern
Following https://discuss.python.org/t/document-that-macos-platform-tags-use-minor-version-0-for-macos-11/104616: * Document that for macOS 11 and later, the platform tag is `macosx_0_{y}_{arch}` * Document that platform tags may change over time.
1 parent 1453fed commit 761f6bd

File tree

1 file changed

+12
-7
lines changed

1 file changed

+12
-7
lines changed

source/specifications/platform-compatibility-tags.rst

Lines changed: 12 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -82,6 +82,11 @@ decide how to best use the ABI tag.
8282
Platform Tag
8383
============
8484

85+
.. important::
86+
Platform tags are dependent on the versioning of the operating system or
87+
platform they represent and may change over time as the underlying platform
88+
changes its versioning.
89+
8590
Basic platform tags
8691
-------------------
8792

@@ -199,13 +204,13 @@ artefact of Apple's official macOS naming scheme). The schema for compatibility
199204
tags is :file:`macosx_{x}_{y}_{arch}`, indicating that the wheel is compatible
200205
with macOS ``x.y`` or later on the architecture ``arch``.
201206

202-
The values of ``x`` and ``y`` correspond to the major and minor version number
203-
of the macOS release, respectively. They must both be positive integers, with
204-
the ``x`` value being either ``10 <= x <= 15``, or ``>=26`` and corresponding
205-
to the year of the macOS release. The version number always includes a major
206-
*and* minor version, even if Apple's official version numbering only refers to
207-
the major value. For example, ``macosx_11_0_arm64`` indicates compatibility
208-
with macOS 11 or later.
207+
For macOS 10, the tag is :file:`macosx_10_{y}_{arch}`, where ``y`` corresponds
208+
to the minor version number of the macOS release. For macOS 11 and higher, the
209+
tag is :file:`macosx_{x}_0_{arch}`, where ``x`` corresponds to the major
210+
version number of the macOS release. Following the published macOS major
211+
versions, the ``x`` value is either ``10 <= x <= 15``, or ``>=26`` and
212+
corresponding to the year of the macOS release. For example,
213+
``macosx_11_0_arm64`` indicates compatibility with macOS 11 or later.
209214

210215
macOS binaries can be compiled for a single architecture, or can include support
211216
for multiple architectures in the same binary (sometimes called "fat" binaries).

0 commit comments

Comments
 (0)