summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/pdftex/manual/pdftex-t.tex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2016-05-09 17:21:10 +0000
committerKarl Berry <karl@freefriends.org>2016-05-09 17:21:10 +0000
commitbb8c2de00333314b9c6297ee0869294f7168b6d7 (patch)
tree18fcc5c7f2b82d63d516eb73253fdfdc2dafdffb /Master/texmf-dist/doc/pdftex/manual/pdftex-t.tex
parent8f72ef069a0a39e3bfcec5bf66ed267d209f1e3e (diff)
SOURCE_DATE_EPOCH not pdftex-only
git-svn-id: svn://tug.org/texlive/trunk@40974 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/pdftex/manual/pdftex-t.tex')
-rw-r--r--Master/texmf-dist/doc/pdftex/manual/pdftex-t.tex35
1 files changed, 18 insertions, 17 deletions
diff --git a/Master/texmf-dist/doc/pdftex/manual/pdftex-t.tex b/Master/texmf-dist/doc/pdftex/manual/pdftex-t.tex
index 36d7de81c28..15d0daa1c50 100644
--- a/Master/texmf-dist/doc/pdftex/manual/pdftex-t.tex
+++ b/Master/texmf-dist/doc/pdftex/manual/pdftex-t.tex
@@ -1,7 +1,7 @@
% interface=english modes=letter,screen output=pdftex
% vim: tw=79
-% $Id: pdftex-t.tex 752 2016-05-04 23:55:19Z karl $
+% $Id: pdftex-t.tex 753 2016-05-09 17:19:54Z karl $
% The number of lines on the title page depends on exactly
% what \PDF\ code is generated.
@@ -38,7 +38,7 @@
August\or September\or October\or November\or December\else ERROR\fi}
}
-\svnscan $Id: pdftex-t.tex 752 2016-05-04 23:55:19Z karl $
+\svnscan $Id: pdftex-t.tex 753 2016-05-09 17:19:54Z karl $
\def\currentpdftex{1.40.17}
@@ -1312,19 +1312,19 @@ options, they are all inherited from the common framework for \TeX\
engines as implemented in \WEBC\ (\from [web2c] has the manual).
The same commonality holds for environment variables; see the section
-``Setting search paths'' above for an overview. However, \PDFTEX\ looks
-for two additional environment variables: first, \type{SOURCE_DATE_EPOCH}
-(introduced in version 1.40.17, 2016). If this is set, it must be a
-positive integer (with one trivial exception: if it is set but empty,
-that is equivalent to 0). Non-integer values cause a fatal error. The
-value is used as the current time in seconds since the usual Unix
-``epoch'': the beginning of 1970-01-01, UTC. Thus, a value of \type{32}
-would result in a \type{/CreationDate} and \type{/ModDate} values of
-\type{19700101000032Z}. This is useful for reproducible builds of
-documents. (See also \type{\pdfinfoomitdate},
+``Setting search paths'' above for an overview. Two additional
+environment variables need more description here: first,
+\type{SOURCE_DATE_EPOCH} (introduced in version 1.40.17, 2016). If this
+is set, it must be a positive integer (with one trivial exception: if it
+is set but empty, that is equivalent to 0). Non-integer values cause a
+fatal error. The value is used as the current time in seconds since the
+usual Unix ``epoch'': the beginning of 1970-01-01, UTC. Thus, a value
+of \type{32} would result in a \type{/CreationDate} and \type{/ModDate}
+values of \type{19700101000032Z}. This is useful for reproducible
+builds of documents. (See also \type{\pdfinfoomitdate},
\type{\pdfsuppressptexinfo}, et al.)
-The second \PDFTEX-specific environment variable is
+The second, related, environment variable is
\type{SOURCE_DATE_EPOCH_TEX_PRIMITIVES}. If this is set to~\type{1},
\TEX's time-related primitives are also initialized from the value of
\type{SOURCE_DATE_EPOCH}. These primitives are \type{\year},
@@ -1338,11 +1338,12 @@ usual. Any other value elicits a warning, and the current time is used.
of documents without changing them in any way, e.g., an operating system
distribution with manuals that use \type{\today}. Except in such
unusual circumstances, it is better not to set this, and let the \TEX\
-primitives have the meaning they have always had.)
+primitives retain the meaning they have always had.)
-Now, just to have the list of options and basic invocation at hand, here
-is a verbatim listing of the \type{-}\type{-help} output. All options
-can be specified with one or two dashes and unambiguously abbreviated.
+Finally, just to have the list of options and basic invocation at hand,
+here is a verbatim listing of the \type{-}\type{-help} output. All
+options can be specified with one or two dashes and unambiguously
+abbreviated.
\startnotmode[screen]
\switchtobodyfont[9pt] % squeeze everything on one page