[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