## page was renamed from ReproducibleBuilds/TimestampInDocumentationGeneratedByDoxygen
If `Doxyfile` contains `HTML_TIMESTAMP = YES`, Doxygen will add a timestamp to its generated (HTML) documentation.

It seems Doxygen has no way to turn it off for man-pages, see [[ReproducibleBuilds/TimestampsInManpagesGeneratedByDoxygen]].

A good amount of potentially affected packages can be [[http://codesearch.debian.net/search?q=HTML_TIMESTAMP.*%3D.*YES|found using codesearch]].

[[https://reproducible.debian.net/userContent/issues/timestamps_in_documentation_generated_by_doxygen_issue.html|Known affected packages]]

= Detection =

[[attachment:libnfo_1.0.1-1.1.debbindiff.html|Example debbindiff output]]

= Solution =

A patch has been sent to Doxygen upstream which honours the implementation of the new environment variable SOURCE_DATE_EPOCH. This was proposed as a way to produce deterministic timestamps [1].

Upstream bug:https://bugzilla.gnome.org/show_bug.cgi?id=751984

This solution avoids having to carry a patch against upstream (only if doxygen is called in `debian/rules`):

{{{
override_dh_auto_build-indep:
    { cat Doxyfile && echo "HTML_TIMESTAMP=NO"; } | doxygen -
}}}

Otherwise, patch upstream

 * either by setting `HTML_TIMESTAMP = NO` in `Doxyfile`
 * or by removing the $timestamp placeholder in the html file referenced by the configuration variable HTML_FOOTER.


[[https://bugs.debian.org/cgi-bin/bugreport.cgi?msg=5;filename=cwidget_0.5.17-1%2Breproducible.patch;att=1;bug=762666|Example patch 1]], [[https://bugs.debian.org/cgi-bin/bugreport.cgi?msg=5;filename=libdebian-installer_0.96%2Breproducible.patch;att=1;bug=762732|Example patch 2]]

[1] https://wiki.debian.org/ReproducibleBuilds/TimestampsProposal