diff options
Diffstat (limited to 'MANUAL.txt')
| -rw-r--r-- | MANUAL.txt | 15 |
1 files changed, 15 insertions, 0 deletions
diff --git a/MANUAL.txt b/MANUAL.txt index dc3b4ca77..486cee0b1 100644 --- a/MANUAL.txt +++ b/MANUAL.txt @@ -6309,6 +6309,21 @@ subdirectory of your user data directory (see [Templates]). [Lua]: https://www.lua.org +# Reproducible builds + +Some of the document formats pandoc targets (such as EPUB, +docx, and ODT) include build timestamps in the generated document. +That means that the files generated on successive builds will +differ, even if the source does not. To avoid this, set the +`SOURCE_DATE_EPOCH` environment variable, and the timestamp will +be taken from it instead of the current time. +`SOURCE_DATE_EPOCH` should contain an integer unix timestamp +(specifying the number of second since midnight UTC January 1, 1970). + +Some document formats also include a unique identifier. For +EPUB, this can be set explicitly by setting the `identifier` +metadata field (see [EPUB Metadata], above). + # A note on security If you use pandoc to convert user-contributed content in a web |