diff options
| author | John MacFarlane <jgm@berkeley.edu> | 2021-02-11 15:17:56 -0800 |
|---|---|---|
| committer | John MacFarlane <jgm@berkeley.edu> | 2021-02-11 15:17:56 -0800 |
| commit | 8c2618ed8150d2b738b3baa4ba23c2d957450105 (patch) | |
| tree | 9d709132c04a6998dccf95a5199893e285752215 /MANUAL.txt | |
| parent | 390d5e65b2d66078b2f9b9db142dbe2167ea29a9 (diff) | |
| download | pandoc-8c2618ed8150d2b738b3baa4ba23c2d957450105.tar.gz | |
Add MANUAL section on reproducible builds.
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 |