[latex3-commits] [git/LaTeX3-latex3-pdfresources] testA4: document new max-pdfversion handler (0ef7237)

[Ulrike Fischer]

Repository : https://github.com/latex3/pdfresources
On branch  : testA4
Link       : https://github.com/latex3/pdfresources/commit/0ef7237bf77d19d189b3720dc188ffef3e9eba13

>---------------------------------------------------------------

commit 0ef7237bf77d19d189b3720dc188ffef3e9eba13
Author: Ulrike Fischer <fischer at troubleshooting-tex.de>
Date:   Thu May 5 11:52:54 2022 +0200

    document new max-pdfversion handler


>---------------------------------------------------------------

0ef7237bf77d19d189b3720dc188ffef3e9eba13
 l3pdfmeta.dtx | 23 ++++++++++++++++++++---
 ltdocinit.dtx |  3 ++-
 2 files changed, 22 insertions(+), 4 deletions(-)

diff --git a/l3pdfmeta.dtx b/l3pdfmeta.dtx
index ea6ac54..e68c650 100644
--- a/l3pdfmeta.dtx
+++ b/l3pdfmeta.dtx
@@ -228,11 +228,28 @@
 %
 % \begin{description}
 %
-% \item[|min_pdf_version|]  stores the minimal PDF version.
+% \item[|min_pdf_version|]  stores the minimal PDF version needed for
+%  a standard.
 %  It should be checked against the current PDF version (\cs{pdf_version:}).
 %  A failure means that the version should be changed.
-%  This check is done by \pkg{l3pdfmeta} when the version is set with
-%  \cs{DocumentMetadata} so more checks are only needed if the version is changed later.
+%  Currently there is only one hard requirement which leads to a failure in
+%  a validator like verapdf: The A-4 standard should use PDF 2.0.
+%  As PDF A-1 is based on PDF 1.4 and PDF A-2 and A-3 are based
+%  on PDF 1.7 \pkg{l3pdfmeta} also sets these versions also as requirements.
+%  These requirements are checked by \pkg{l3pdfmeta} when the version is set with
+%  \cs{DocumentMetadata} and a warning is issued (but the version is
+%  not changed). More checks are only needed if the version is changed later.
+%
+%
+% \item[|max_pdf_version|]  stores the maximal PDF version.
+%  It should be checked against the current PDF version (\cs{pdf_version:}).
+%  A failure means that the version should be changed.
+%  The check is currently relevant only for the A-1 to A-3 standards:
+%  PDF 2.0 leads to a failure in a validator like verapdf so the maximal
+%  version should be PDF 1.7.
+%  This requirement is checked by \pkg{l3pdfmeta} when the version is set with
+%  \cs{DocumentMetadata} and a warning is issued (but the version is
+%  not changed). More checks are only needed if the version is changed later.
 %
 % \item[|named_actions|]    this requirement restricts the list of
 % allowed named actions to |NextPage|, |PrevPage|, |FirstPage|, |LastPage|.
diff --git a/ltdocinit.dtx b/ltdocinit.dtx
index 7f790be..dfe4e58 100644
--- a/ltdocinit.dtx
+++ b/ltdocinit.dtx
@@ -117,7 +117,8 @@
 %     e.g., \texttt{lang=de-DE}. If not given the default value used is |en-US|.
 %
 %    \item[\texttt{pdfstandard}] Choice key to set the pdf standard.
-%      Currently |A-1b|, |A-2a|, |A-2b|, |A-2u|, |A-3a|, |A-3b| and |A-3u| are accepted as
+%      Currently |A-1b|, |A-2a|, |A-2b|, |A-2u|, |A-3a|, |A-3b|, |A-3u| and |A-4|
+%      are accepted as
 %      values. The casing is irrelevant, |a-1b| works too.
 %      The underlying code to ensure the requirements (as far as they
 %      can be ensured) is still incomplete, but a color profile is included and the