Commits

Nick Coghlan committed 67f6e8f

Issue #31: tweak wording in label rationales

Comments (0)

Files changed (1)

 as they are able to translate it to something the dependency analysis tools
 will understand.
 
+Source labels also make it straightforward to record specific details of a
+version, like a hash or tag name that allows the release to be reconstructed
+from the project version control system.
+
 
 Changing the version scheme
 ---------------------------
 characters), instead treating them as opaque strings that have no inherent
 order and can only be compared for strict equality.
 
-The hyphen is chosen primarily for readability of local version identifiers.
-While the wheel format also uses hyphens as separators between components,
-the escaping rules defined in PEP 427 will convert the hyphen in a local
-version identifier to an underscore before using it in a wheel filename
-(alternatively, a future iteration of the wheel specification may map the
-optional "build tag" component of the wheel file naming scheme to the
-"local version label" component in this PEP).
-
 This change is designed to ensure that an integrator provided version like
 ``pip 1.5-1`` or ``pip-1.5-1.git.abc123de`` will still satisfy a version
 specifier like ``pip (>= 1.5)``.
 
+The hyphen is chosen primarily for readability of local version identifiers.
+While the wheel format also uses hyphens as separators between components,
+the escaping rules defined in PEP 427, a future iteration of the wheel
+specification will likely end up replacing the current optional "build tag"
+component of the wheel file naming scheme with the "local version label"
+component from this PEP.
+
+By permitting the use of local version identifiers for binary distributions,
+even on public index servers, and allowing the use of "+" characters in
+local version labels, this change combines with the introduction of
+source labels to make it possible to include build tags in distribution
+metadata, without interfering with the requirement for fully ordered
+public version identifiers.
+
 
 References
 ==========