From 8c2618ed8150d2b738b3baa4ba23c2d957450105 Mon Sep 17 00:00:00 2001 From: John MacFarlane Date: Thu, 11 Feb 2021 15:17:56 -0800 Subject: Add MANUAL section on reproducible builds. --- MANUAL.txt | 15 +++++++++++++++ 1 file changed, 15 insertions(+) (limited to 'MANUAL.txt') 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 -- cgit v1.2.3