This is an automated email from the git hooks/post-receive script.

guillem pushed a commit to branch main
in repository dpkg.

View the commit online:
https://git.dpkg.org/cgit/dpkg/dpkg.git/commit/?id=246386ca46ee0e84fb4960ef1bea7afbf31ed652

commit 246386ca46ee0e84fb4960ef1bea7afbf31ed652
Author: Guillem Jover <[email protected]>
AuthorDate: Wed Feb 8 11:26:14 2023 +0100

    man: Add notes about reproducibility properties for path fixing build 
features
    
    Mention that if the build captures the build flags that will make it
    unreproducible, the traps with trying to disable these flags to get
    back to a reproducible output. And that the ideal fix is to stop
    capturing build flags.
    
    Prompted-by: Sven Joachim <[email protected]>
---
 man/dpkg-buildflags.pod | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/man/dpkg-buildflags.pod b/man/dpkg-buildflags.pod
index 6067d4923..01c14269e 100644
--- a/man/dpkg-buildflags.pod
+++ b/man/dpkg-buildflags.pod
@@ -622,6 +622,13 @@ This has the effect of removing the build path from any 
generated file.
 If both B<fixdebugpath> and B<fixfilepath> are set, this option
 takes precedence, because it is a superset of the former.
 
+B<Note>: If the build process captures the build flags into the resulting
+built objects, that will make the package unreproducible.
+And while disabling this option might make some of the objects reproducible
+again this would also require disabling B<fixdebugpath>, which might make
+any generated debug symbols objects unreproducible.
+The ideal fix is to stop capturing build flags.
+
 =item B<fixdebugpath>
 
 This setting (enabled by default) adds
@@ -632,6 +639,8 @@ set to the top-level directory of the package being built.
 This has the effect of removing the build path from any generated debug
 symbols.
 
+B<Note>: This feature has similar reproducible properties as B<fixfilepath>.
+
 =back
 
 =head1 ENVIRONMENT

-- 
Dpkg.Org's dpkg

Reply via email to