mirror of
https://github.com/sphinx-doc/sphinx.git
synced 2025-02-25 18:55:22 -06:00
267fe9afa8
Sphinx's copyright substitution currently allows years identified as the current year to be downgraded to previous years when ``SOURCE_DATE_EPOCH`` is configured, to assist reproducibility [1] of documentation builds. However, we have a test case ``test_html_multi_line_copyright``, written in 2024, that mentioned a future year (2025). Now that we have reached 2025, it is eligible for substitution when ``SOURCE_DATE_EPOCH`` is configured. Many buildsystems, such as those used by Debian and Fedora, choose the most-recent packaging/commit timestamp to use as `SOURCE_DATE_EPOCH`'s timestamp, since those correspond sensibly to a time-of-build. However, for the Sphinx 8.1.3 release including the updated substitution logic, the year-of-release/commit was 2024. Thus, if a commit/packaging date from that year is chosen, and ``SOURCE_DATE_EPOCH`` is configured when the unit tests run, the ``test_html_multi_line_copyright`` test will fail. The fix suggested here is to explicitly unset ``SOURCE_DATE_EPOCH`` within ``test_html_multi_line_copyright``. [1]: https://www.reproducible-builds.org/ Authored-by: Colin Watson <cjwatson@debian.org> Co-authored-by: Colin Watson <cjwatson@debian.org> Authored-by: James Addison <55152140+jayaddison@users.noreply.github.com> Co-authored-by: James Addison <55152140+jayaddison@users.noreply.github.com> |
||
|---|---|---|
| .. | ||
| certs | ||
| js | ||
| roots | ||
| test_builders | ||
| test_config | ||
| test_directives | ||
| test_domains | ||
| test_environment | ||
| test_extensions | ||
| test_intl | ||
| test_markup | ||
| test_pycode | ||
| test_theming | ||
| test_transforms | ||
| test_util | ||
| test_writers | ||
| __init__.py | ||
| conftest.py | ||
| test_addnodes.py | ||
| test_application.py | ||
| test_command_line.py | ||
| test_errors.py | ||
| test_events.py | ||
| test_highlighting.py | ||
| test_project.py | ||
| test_quickstart.py | ||
| test_roles.py | ||
| test_search.py | ||
| test_versioning.py | ||
| utils.py | ||