Tissevert/pandoc
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1

Add MANUAL section on reproducible builds.

Browse source
This commit is contained in:
John MacFarlane 2021-02-11 15:17:56 -08:00
parent 390d5e65b2
commit 8c2618ed81
1 changed files with 15 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

15
MANUAL.txt
View file

@ -6309,6 +6309,21 @@ subdirectory of your user data directory (see [Templates]).
[Lua]: https://www.lua.org [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 # A note on security
If you use pandoc to convert user-contributed content in a web If you use pandoc to convert user-contributed content in a web