[build-path-prefix-map-spec] 03/03: Clarify wording around "general consumers"
Ximin Luo
infinity0 at debian.org
Tue Mar 21 11:20:45 UTC 2017
This is an automated email from the git hooks/post-receive script.
infinity0 pushed a commit to branch master
in repository build-path-prefix-map-spec.
commit bfe9197808dd01403cdc997e6d3e53920d70d615
Author: Ximin Luo <infinity0 at debian.org>
Date: Tue Mar 21 12:20:28 2017 +0100
Clarify wording around "general consumers"
---
build-path-prefix-map-spec.in.rst | 15 ++++++++-------
1 file changed, 8 insertions(+), 7 deletions(-)
diff --git a/build-path-prefix-map-spec.in.rst b/build-path-prefix-map-spec.in.rst
index f0afd04..f53e76b 100644
--- a/build-path-prefix-map-spec.in.rst
+++ b/build-path-prefix-map-spec.in.rst
@@ -170,13 +170,14 @@ mapping for each top-level directory that the build is expected to take place
under. Each mapping has the reproducible *target* path prefix on the left, and
the unreproducible *source* path prefix on the right.
-Producers who build *general software* that uses this variable, MUST NOT expect
-any special contracts on the output emitted by *general consumers* based on
-this variable ― only that their output be reproducible when the build path
-changes and the value of this variable is changed to match the new paths.
-
-On the other hand, if you know you will only support a limited set of
-consumers, you may expect that they apply these mappings in specific ways.
+Producers such as top-level distribution package builders, that expect
+*arbitrary consumers* to read this variable, MUST NOT expect any additional
+constraints or special contracts on the output emitted by these consumers ―
+only that their output be reproducible when the build path changes and the
+value of this variable is changed to match the new paths.
+
+On the other hand, producers that only support a limited set of consumers, may
+expect that these consumers apply these mappings in particular ways.
See also the requirements for consumers in the next part for guidance.
--
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/reproducible/build-path-prefix-map-spec.git
More information about the Reproducible-commits
mailing list