Bug#779223: box2d: please make the build reproducible

[marivalen]

On 02/25/2015 08:15 PM, Markus Koschany wrote:
> 1. doxygen should be patched and always set HTML_TIMESTAMPS = NO in
>     Debian.
>

Debian doxygen maintainers seem to be reluctant to deviate from upstream 
(see #778490). So I filed a bug report to upstream about changing the 
default (see https://bugzilla.gnome.org/show_bug.cgi?id=745439 )

> 2. dh_doxygen in the doxygen package could be enhanced to parse the
>     Doxyfile and to set HTML_TIMESTAMPS = NO
>     This would solve the issue for all packages that use debhelper, dh
>     and doxygen. As far as I am aware of Doxyfile is the standard
>     configuration file for doxygen, so that this scenario is the most
>     common one.

Doxyfile is the default configuration file name if no configuration file 
was given to doxygen. But this is less common than you think.

I ran a script across the 300 source packages which are affected by this 
issue and before compilation changed or added the HTML_TIMESTAMP 
variable to not generate timestamps. You can find the script attached.
It turns out that only 14% of all packages become reproducible after 
this change.

In addition, changing all files that are named Doxyfile in this way 
might also result in build failures because it is very hard to determine 
whether a file called Doxyfile is really a doxygen configuration file 
and really used for documentation generation or used for other purposes. 
For example src:doxygen uses a file called Doxyfile in its test suite. 
So any implementation like this would have to carry and maintain a 
blacklist to detect files that are named Doxyfile but should not be changed.

On the other hand filing patches to the remaining 14% allows maintainers 
to forward the patch to the respective upstreams and does not hide the 
problem.

> The problem is that HTML_TIMESTAMPS = YES is the default value for doxygen.
>
> http://www.stack.nl/~dimitri/doxygen/manual/config.html#cfg_html_timestamp
>
> That means new packages using doxygen will almost always be affected by
> it. Hence I suggest to file a bug report against doxygen and to discuss
> the above mentioned solutions with its maintainers because I feel this
> would be the technically correct approach.

The bug had been filed as I explained above, but changing the default 
would not affect box2d because it explicitly has HTML_TIMESTAMP set to YES

Kind Regards, akira

-------------- next part --------------
A non-text attachment was scrubbed...
Name: run.sh
Type: application/x-shellscript
Size: 4078 bytes
Desc: not available
URL: <http://lists.alioth.debian.org/pipermail/pkg-games-devel/attachments/20150302/7da6122c/attachment.bin>