pdftex[932] branches/stable/doc/manual: (\pdfuseptexuseunderscore):

[commits+karl at tug.org]

Revision: 932
          https://tug.org/svn/pdftex?view=revision&revision=932
Author:   karl
Date:     2024-07-21 19:07:35 +0200 (Sun, 21 Jul 2024)
Log Message:
-----------
(\pdfuseptexuseunderscore): new section

Modified Paths:
--------------
    branches/stable/doc/manual/ChangeLog
    branches/stable/doc/manual/pdftex.tex

Modified: branches/stable/doc/manual/ChangeLog
===================================================================
--- branches/stable/doc/manual/ChangeLog	2024-06-23 22:04:31 UTC (rev 931)
+++ branches/stable/doc/manual/ChangeLog	2024-07-21 17:07:35 UTC (rev 932)
@@ -1,3 +1,7 @@
+2024-07-21  Karl Berry  <karl at freefriends.org>
+
+	* pdftex.tex (\pdfuseptexuseunderscore): new section.
+
 2024-02-22  Max Chernoff  <karl at freefriends.org>
 
 	* pdftex.tex (\pdfximage): mentioned named destination

Modified: branches/stable/doc/manual/pdftex.tex
===================================================================
--- branches/stable/doc/manual/pdftex.tex	2024-06-23 22:04:31 UTC (rev 931)
+++ branches/stable/doc/manual/pdftex.tex	2024-07-21 17:07:35 UTC (rev 932)
@@ -1020,7 +1020,7 @@
 \type{/Producer} (defaults to \hbox{\tt pdfTeX-\currentpdftex}),\newline
 \type{/Creator} (defaults to \type{TeX}),\newline
 \type{/CreationDate} (defaults to current date and time, with time zone),\newline
-\type{/ModDate} (same default),\newline
+\type{/ModDate} (same default as \type{/CreationDate}),\newline
 \type{/Trapped} (defaults to \type{/False},\newline
 \type{/PTEX.Fullbanner} (defaults to the \cs{pdftexbanner} string, q.v.).
 
@@ -1157,6 +1157,21 @@
 omitted entirely.  Example: \verb|\pdftrailerid{}|.  This can be useful
 in making reproducible \PDF{}s.  \introduced{1.40.17}
 
+\subsection{\cs{pdfuseptexunderscore}}
+\pdftexprimitive{\Syntax{\cs{pdfuseptexunderscore} \Whatever{integer}}}
+
+If this parameter is zero, and \cs{pdfmajorversion} is $<2$, use
+`\type{/PTEX.} as the prefix for the relevant \type{/Info} keys, as was
+done through 2024. If this parameter is $>0$, or \cs{pdfmajorversion} is
+$\ge2$, use `\type{PTEX_}', with underscore instead of period. For
+example, if \cs{pdfmajorversion=2}, the key \type{/PTEX_Fullbanner} will
+be defined instead of \type{/PTEX.Fullbanner}.
+
+Using \type{_} is required by updates to the PDF 32000-2-2020 standard,
+and/or by validators; for backwards compatibility, PDF 1.x output still
+uses \type{.}\ by default.
+\introduced{1.40.27}
+
 \section{Fonts}
 
 \subsection{\cs{pdfadjustspacing}}