diff --git a/source/specifications/platform-compatibility-tags.rst b/source/specifications/platform-compatibility-tags.rst index 72df34777..258abab03 100644 --- a/source/specifications/platform-compatibility-tags.rst +++ b/source/specifications/platform-compatibility-tags.rst @@ -8,6 +8,21 @@ Platform compatibility tags The platform compatibility tagging model used for ``wheel`` distribution is defined in :pep:`425`. -The scheme defined in that PEP is insufficient for public distribution -of Linux wheel files (and \*nix wheel files in general), so :pep:`513` was -created to define the ``manylinux1`` tag. +.. _manylinux: + +Manylinux tags +============== + +The scheme defined in :pep:`425` is insufficient for public distribution +of Linux wheel files (and \*nix wheel files in general), so the *manylinux* +platform tags were defined, to allow providing wheels for many common Linux +distributions. See :pep:`513` for more about how this works. + +* ``manylinux1`` is defined in :pep:`513`, for x86_64 and i686 architectures. +* ``manylinux2010`` is defined in :pep:`571`, for x86_64 and i686 architectures. + It is based on a platform from 2010, whereas ``manylinux1`` is based on a + platform from 2007. This means that ``manylinux2010`` packages are easier to + create, but not compatible with some older systems where ``manylinux1`` + packages would work. + + ``manylinux2010`` is not yet widely recognised by install tools.