[build-path-prefix-map-spec] 01/03: Add note on raising an exception when U+FFFD is found

[Ximin Luo]

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 7cb8f0b567a4e01256c1ca7ce7f3df43c3a99500
Author: Ximin Luo <infinity0 at debian.org>
Date:   Tue Mar 21 12:04:03 2017 +0100

    Add note on raising an exception when U+FFFD is found
---
 build-path-prefix-map-spec.in.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/build-path-prefix-map-spec.in.rst b/build-path-prefix-map-spec.in.rst
index 9b81256..a057cca 100644
--- a/build-path-prefix-map-spec.in.rst
+++ b/build-path-prefix-map-spec.in.rst
@@ -220,7 +220,9 @@ Notes and links
     or ``wchar_t`` sequences that are invalid UTF-16, must be decoded into
     distinct application-level character string values. This is not satisfied
     by most standard Unicode decoding strategies, which is to replace all
-    invalid input sequences with ``U+FFFD REPLACEMENT CHARACTER``.
+    invalid input sequences with ``U+FFFD REPLACEMENT CHARACTER``. For these
+    cases, the easiest way to be compliant is to check the decode output for
+    this character and raise an "unsupported" exception if it is found.
 
 .. [2] Detailed implementation notes and advice are available on `our wiki page
     <https://wiki.debian.org/ReproducibleBuilds/BuildPathProposal#Implementation_notes>`_.

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/reproducible/build-path-prefix-map-spec.git