Source: glfw3
Version: 3.0.4-1
Severity: wishlist
Tags: patch
User: reproducible-bui...@lists.alioth.debian.org
Usertags: timestamps

Hi,

While working on the “reproducible builds” effort [1], we have noticed
that glfw3 could not be built reproducibly.

The attached patch changes the value of HTML_TIMESTAMP in upstream's
doxyfile to NO. Once applied glfw3 can be built reproducibly in our
current experimental framework.

Patching upstream doxyfile is necessary in this case because of the
following reasons:

1. Even though the doxygen upstream changed the default value of
HTML_TIMESTAMP from YES to NO this does not affect this package because
the value of HTML_TIMESTAMP is explicitly set to YES.

2. Upstream's doxyfiles cannot reliably be modified to change the value
of HTML_TIMESTAMP during the build process because dh_doxygen is only
run after the build already completed and even adding a new dh command
cannot solve the problem because there exists no sane and reliable
solution to detect the file which will be used as the configuration file
for doxygen (it is not always called doxyfile).

3. In case of this source package a patch against upstream is necessary
in contrast to a patch against Debian rules because this source package
does not call doxygen in debian/rules.

Please also consider forwarding this patch upstream.

Cheers!
akira

 [1]: https://wiki.debian.org/ReproducibleBuilds
Description: Set HTML_TIMESTAMP to NO to make package reproducible 

--- glfw3-3.0.4.orig/docs/Doxyfile.in
+++ glfw3-3.0.4/docs/Doxyfile.in
@@ -965,7 +965,7 @@ HTML_COLORSTYLE_GAMMA  = 80
 # page will contain the date and time when the page was generated. Setting
 # this to NO can help when comparing the output of multiple runs.
 
-HTML_TIMESTAMP         = YES
+HTML_TIMESTAMP         = NO
 
 # If the HTML_DYNAMIC_SECTIONS tag is set to YES then the generated HTML
 # documentation will contain sections that can be hidden and shown after the

Reply via email to