Merge pull request pypa#1277 from sethmlarson/build-number-interop

manolotron · Aug 3, 2023 · 94648bd · 94648bd
2 parents c022989 67ea0ff
commit 94648bd
Showing 1 changed file with 17 additions and 0 deletions.
diff --git a/source/specifications/binary-distribution-format.rst b/source/specifications/binary-distribution-format.rst
@@ -134,6  134,23 @@ build tag
     the first item being the initial digits as an ``int``, and the
     second item being the remainder of the tag as a ``str``.
 
     A common use-case for build numbers is rebuilding a binary
     distribution due to a change in the build environment,
     like when using the manylinux image to build
     distributions using pre-release CPython versions.
 
     .. warning::
 
         Build numbers are not a part of the distribution version and thus are difficult
         to reference externally, especially so outside the Python ecosystem of tools and standards.
         A common case where a distribution would need to referenced externally is when
         resolving a security vulnerability.
 
         Due to this limitation, new distributions which need to be referenced externally
         **should not** use build numbers when building the new distribution.
         Instead a **new distribution version** should be created for such cases.
 
 
 language implementation and version tag
     E.g. 'py27', 'py2', 'py3'.