Bug#1034499: twisted: reproducible builds: timestamp embedded in .html documentation

[Vagrant Cascadian]

Source: twisted
Severity: normal
Tags: patch
User: reproducible-builds at lists.alioth.debian.org
Usertags: timestamps
X-Debbugs-Cc: reproducible-bugs at lists.alioth.debian.org

The year and date are embedded in various pieces of .html documentation:

  https://tests.reproducible-builds.org/debian/rb-pkg/bookworm/amd64/diffoscope-results/twisted.html

  /usr/share/doc/twisted-doc/html/api.sphinx_files/index.html

  Copyright·2023,·Twisted·Matrix·Labs.·Ver·22.4.0.·Built·on·2024-04-13.
  vs.
  Copyright·2023,·Twisted·Matrix·Labs.·Ver·22.4.0.·Built·on·2023-03-13.

The attached patch removes the year and date references in
docs/conf.py.

The build date can be found on buildd.debian.org if needed, and it is
likely inaccurate to derive the copyright date from the build date;
building it one year after the last source modification (e.g. the
copyrightable content) will always result in an incorrect year.

Another possible approach would be to use SOURCE_DATE_EPOCH, although
this is still inaccurate for the copyright information, and arguably
misleading to use as a build date.


According to my local tests, with this patch applied, twisted should
build reproducibly on tests.reproducible-builds.org!


Thanks for maintaining twisted!


live well,
  vagrant
-------------- next part --------------
A non-text attachment was scrubbed...
Name: 0001-docs-conf.py-Remove-timestamps-from-documentation.patch
Type: text/x-diff
Size: 1369 bytes
Desc: not available
URL: <http://alioth-lists.debian.net/pipermail/reproducible-bugs/attachments/20230416/ead500b8/attachment.patch>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 227 bytes
Desc: not available
URL: <http://alioth-lists.debian.net/pipermail/reproducible-bugs/attachments/20230416/ead500b8/attachment.sig>