Add MANUAL section on reproducible builds.

This commit is contained in:
John MacFarlane 2021-02-11 15:17:56 -08:00
parent 390d5e65b2
commit 8c2618ed81

View file

@ -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