Sphinx: copyright substitution and reproducibility
Bernhard M. Wiedemann
bernhardout at lsmod.de
Wed Jul 10 06:01:59 UTC 2024
On 09/07/2024 14.14, James Addison via rb-general wrote:
> Although I think there are reasons to prefer and encourage static (constant)
> declaration of copyright notices, many projects today do choose to use
> dynamically-evaluated values.
>
> I doubt there's a way to solve every edge case, but I think that it should be
> possible to vastly reduce the number of clearly-incorrect copyright notice
> outputs that could occur, while retaining both backwards compatibility and also
> build reproducibility.
Using a dynamic copyright year can only produce correct results, when it
is ensured that it is not newer than input files (and even then,
applying a patch updates the mtime of input files).
E.g. when using current year as copyright, today's software/docs
re-built in 9 months, will show Copyright 2025, which is clearly
incorrect, as nobody did anything copyright-worthy in 2025 in that version.
IMHO, the correct solution is to use static copyright year. Or none at all.
In many places, copyright is valid until 50-70 years after the death of
its author. [1]
So you only need to update the year every few decades, when you do changes.
Ciao
Bernhard M.
[1] https://en.wikipedia.org/wiki/Copyright#Duration
More information about the rb-general
mailing list