[latex3-commits] [git/LaTeX3-latex3-pdfresources] testmetadata: update copyright date, change DeclareDocumentMetadata to new command (f7d1a4d)
Ulrike Fischer
fischer at troubleshooting-tex.de
Mon Jan 10 21:10:48 CET 2022
Repository : https://github.com/latex3/pdfresources
On branch : testmetadata
Link : https://github.com/latex3/pdfresources/commit/f7d1a4d59694c8793837688241011f0c79bef931
>---------------------------------------------------------------
commit f7d1a4d59694c8793837688241011f0c79bef931
Author: Ulrike Fischer <fischer at troubleshooting-tex.de>
Date: Mon Jan 10 21:10:48 2022 +0100
update copyright date, change DeclareDocumentMetadata to new command
>---------------------------------------------------------------
f7d1a4d59694c8793837688241011f0c79bef931
CHANGELOG.md | 4 ++-
hyperref-generic.dtx | 69 ++++++++++++++++++++++++++++++--------------
l3pdfannot.dtx | 4 +--
l3pdfdict.dtx | 4 +--
l3pdffield-action.dtx | 4 +--
l3pdffield-checkbox.dtx | 4 +--
l3pdffield-choice.dtx | 4 +--
l3pdffield-pushbutton.dtx | 4 +--
l3pdffield-radiobutton.dtx | 4 +--
l3pdffield-textfield.dtx | 4 +--
l3pdffield.dtx | 6 ++--
l3pdffile.dtx | 4 +--
l3pdfmanagement.dtx | 6 ++--
l3pdfmeta.dtx | 12 ++++----
l3pdftools.dtx | 4 +--
l3pdfxform.dtx | 4 +--
ltdocinit.dtx | 4 +--
ltdocinit.pdf | Bin 537194 -> 558342 bytes
pdfmanagement-firstaid.dtx | 8 ++---
pdfmanagement-testphase.dtx | 35 ++++++++++++----------
20 files changed, 110 insertions(+), 78 deletions(-)
diff --git a/CHANGELOG.md b/CHANGELOG.md
index ce8d0f2..dffe295 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -8,7 +8,6 @@ this project uses date-based 'snapshot' version identifiers.
## [XXXX-XX-XX]
### Changed
- the keys `firstaidoff` and `pdfmanagement` should now be set with the `debug` key.
- - the activate key has been removed, its function is integrated in the testphase key.
- `testphase=tagpdf` will execute the tagpdf keys `activate,paratagging,interwordspace`
and so automatically activate tagging.
- testphase will now load files from the latex-lab bundle
@@ -19,6 +18,9 @@ this project uses date-based 'snapshot' version identifiers.
- adapted the file hooks to the changes in LaTeX
- small bugs
+### Removed
+
+ - the activate key has been removed, its function is integrated in the testphase key.
## [2021-08-28]
diff --git a/hyperref-generic.dtx b/hyperref-generic.dtx
index ea0e286..228410b 100644
--- a/hyperref-generic.dtx
+++ b/hyperref-generic.dtx
@@ -2,7 +2,7 @@
%
%% File: hyperref-generic.dtx
%
-% Copyright (C) 2021 The LaTeX Project
+% Copyright (C) 2021-2022 The LaTeX Project
%
% It may be distributed and/or modified under the conditions of the
% LaTeX Project Public License (LPPL), either version 1.3c of this
@@ -26,7 +26,7 @@
%
%<*driver>
\RequirePackage{pdfmanagement-testphase}
-\DeclareDocumentMetadata{pdfstandard=A-2b}
+\DocumentMetadata{pdfstandard=A-2b}
\makeatletter
\declare at file@substitution{doc.sty}{doc-v3beta.sty}
\makeatother
@@ -104,7 +104,7 @@
% should start like this
% \begin{verbatim}
% \RequirePackage{pdfmanagement-testphase} %loads the code
-% \DeclareDocumentMetadata % activates it
+% \DocumentMetadata % activates it
% {
% %% options
% %% e.g. pdf version, backend:
@@ -113,6 +113,18 @@
% }
% \end{verbatim}
%
+% Starting with \LaTeX-2022-06-01 (or a suitable latex-dev) loading the testphase
+% package is no longer required and this can be simplified to
+% \begin{verbatim}
+% \DocumentMetadata
+% {
+% %% options
+% %% e.g. pdf version, backend:
+% % pdfversion=1.7,
+% % backend = dvipdfmx
+% }
+% \end{verbatim}
+
% The new driver tries to be compatible with the standard \pkg{hyperref} drivers
% but there are nevertheless differences. Some of them due to the still experimental
% status of the driver, others are design decisions: one part of the project is
@@ -201,10 +213,9 @@
% If the key hasn't be set, the result is empty. This gives external
% packages a public and reliable access to the data.
%
-% \item |pdflang| is deprecated. Instead \cs{DeclareDocumentMetadata}
-% should be used:
+% \item |pdflang| is deprecated. Instead \cs{DocumentMetadata} should be used:
% \begin{verbatim}
-% \DeclareDocumentMetadata{lang=de-DE}
+% \cs{DocumentMetadata}{lang=de-DE}
% \end{verbatim}
%
% The value can be retrieved as |document/lang|.
@@ -626,7 +637,7 @@
% \section{Dropped options}
% A number of options are ignored by this driver
% \begin{description}
-% \item[pdfversion] The pdfversion should be set in \cs{DeclareDocumentMetadata}
+% \item[pdfversion] The pdfversion should be set in \cs{DocumentMetadata}
% \item[setpagesize] The key is ignored and the PDF page size is not
% set. Load \pkg{color} or \pkg{graphicx} or use a class which sets the PDF page size.
% \item[breaklinks] The option does nothing sensible anyway (apart from triggering
@@ -636,9 +647,9 @@
% \item[pdfa] If this option is set to true \pkg{hyperref} normally checks and sets
% a small number of requirements for the PDF standard PDF/A.
% The key is ignored with this driver. Instead the wanted standard should be declared
-% in \cs{DeclareDocumentMetadata}:
+% in \cs{DocumentMetadata}:
% \begin{verbatim}
-% \DeclareDocumentMetadata{pdfstandard=A-2b}
+% \DocumentMetadata{pdfstandard=A-2b}
% \end{verbatim}
% Currently |A-1b|, |A-2b|, |A-3b| can be set.
% The support for various requirements is still incomplete, but the parts that
@@ -882,7 +893,7 @@
% the setting is global (and has to be done in the preamble).
%
% \DescribeHypkey{pdflang} The key will work, but it is recommended to the set
-% the language in \cs{DeclareDocumentMetadata} instead.
+% the language in \cs{DocumentMetadata} instead.
%^^A %% This is an adapted version of hluatex.def
%^^A %% meant to test the use of the commands
%^^A %% from pdfmanagement.sty
@@ -971,31 +982,45 @@
% \end{macrocode}
% At first a message for the testing of the resource management
% \begin{macrocode}
-\msg_new:nnnn
- { hyp }
- { missing-resource-management }
- { The~PDF~resource~management~is~required~for~this~hyperref~driver! }
+\cs_if_exist:NTF \DocumentMetadata
{
- Activate~it~with \\
- \tl_to_str:n{\RequirePackage{pdfmanagement-testphase}}\\
- \tl_to_str:n{\DeclareDocumentMetadata{<options>}}\\
- before~\tl_to_str:n{\documentclass}
+ \msg_new:nnnn
+ { hyp }
+ { missing-resource-management }
+ { The~PDF~resource~management~is~required~for~this~hyperref~driver! }
+ {
+ Activate~it~with \\
+ \tl_to_str:n{\DocumentMetadata{<options>}}\\
+ before~\tl_to_str:n{\documentclass}
+ }
}
+ {
+ \msg_new:nnnn
+ { hyp }
+ { missing-resource-management }
+ { The~PDF~resource~management~is~required~for~this~hyperref~driver! }
+ {
+ Activate~it~with \\
+ \tl_to_str:n{\RequirePackage{pdfmanagement-testphase}}\\
+ \tl_to_str:n{\DocumentMetadata{<options>}}\\
+ before~\tl_to_str:n{\documentclass}
+ }
+ }
% \end{macrocode}
-% The pdfversion should be set in \cs{DeclareDocumentMetadata}
+% The pdfversion should be set in \cs{DocumentMetadata}
% \begin{macrocode}
\msg_new:nnnn
{ hyp }
{ pdfversion-disabled }
{
This~hyperref~driver~ignores~the~pdfversion~key!\\
- Set~the~pdfversion~in~\token_to_str:N \DeclareDocumentMetadata
+ Set~the~pdfversion~in~\token_to_str:N \DocumentMetadata
}
{
For example:\\
\tl_to_str:n
{
- \DeclareDocumentMetadata { pdfversion=1.7 }
+ \DocumentMetadata { pdfversion=1.7 }
}
}
% \end{macrocode}
@@ -1163,7 +1188,7 @@
\def\Hy at numberline#1{#1\c_space_tl} %needed by bookmark
% \end{macrocode}
%
-% The pdfversion should be set in \cs{DeclareDocumentMetadata} but we must
+% The pdfversion should be set in \cs{DocumentMetadata} but we must
% copy it to the \pkg{hyperref} command:
% \begin{macrocode}
\cs_set_eq:NN \Hy at pdfminorversion \pdf_version_minor:
diff --git a/l3pdfannot.dtx b/l3pdfannot.dtx
index 03df126..a3d0a5b 100644
--- a/l3pdfannot.dtx
+++ b/l3pdfannot.dtx
@@ -2,7 +2,7 @@
%
%% File: l3pdfannot.dtx
%
-% Copyright (C) 2021 The LaTeX Project
+% Copyright (C) 2021-2022 The LaTeX Project
%
% It may be distributed and/or modified under the conditions of the
% LaTeX Project Public License (LPPL), either version 1.3c of this
@@ -24,7 +24,7 @@
%
%<*driver>
\RequirePackage{pdfmanagement-testphase}
-\DeclareDocumentMetadata{pdfstandard=A-2b}
+\DocumentMetadata{pdfstandard=A-2b}
\makeatletter
\declare at file@substitution{doc.sty}{doc-v3beta.sty}
\makeatother
diff --git a/l3pdfdict.dtx b/l3pdfdict.dtx
index 354d9a8..7aecf28 100644
--- a/l3pdfdict.dtx
+++ b/l3pdfdict.dtx
@@ -2,7 +2,7 @@
%
%% File: l3pdfdict.dtx
%
-% Copyright (C) 2018-2021 The LaTeX Project
+% Copyright (C) 2018-2022 The LaTeX Project
%
% It may be distributed and/or modified under the conditions of the
% LaTeX Project Public License (LPPL), either version 1.3c of this
@@ -24,7 +24,7 @@
%
%<*driver>
\RequirePackage{pdfmanagement-testphase}
-\DeclareDocumentMetadata{pdfstandard=A-2b}
+\DocumentMetadata{pdfstandard=A-2b}
\makeatletter
\declare at file@substitution{doc.sty}{doc-v3beta.sty}
\makeatother
diff --git a/l3pdffield-action.dtx b/l3pdffield-action.dtx
index 85852e8..2c951da 100644
--- a/l3pdffield-action.dtx
+++ b/l3pdffield-action.dtx
@@ -2,7 +2,7 @@
%
%% File: l3pdfpdffield-action.dtx
%
-% Copyright (C) 2021 The LaTeX Project
+% Copyright (C) 2021-2022 The LaTeX Project
%
% It may be distributed and/or modified under the conditions of the
% LaTeX Project Public License (LPPL), either version 1.3c of this
@@ -24,7 +24,7 @@
%
%<*driver>
\RequirePackage{pdfmanagement-testphase}
-\DeclareDocumentMetadata{}
+\DocumentMetadata{}
\makeatletter
\declare at file@substitution{doc.sty}{doc-v3beta.sty}
\makeatother
diff --git a/l3pdffield-checkbox.dtx b/l3pdffield-checkbox.dtx
index 11d1c86..ae92aba 100644
--- a/l3pdffield-checkbox.dtx
+++ b/l3pdffield-checkbox.dtx
@@ -2,7 +2,7 @@
%
%% File: l3pdfpdffield-checkbox.dtx
%
-% Copyright (C) 2021 The LaTeX Project
+% Copyright (C) 2021-2022 The LaTeX Project
%
% It may be distributed and/or modified under the conditions of the
% LaTeX Project Public License (LPPL), either version 1.3c of this
@@ -24,7 +24,7 @@
%
%<*driver>
\RequirePackage{pdfmanagement-testphase}
-\DeclareDocumentMetadata{}
+\DocumentMetadata{}
\makeatletter
\declare at file@substitution{doc.sty}{doc-v3beta.sty}
\makeatother
diff --git a/l3pdffield-choice.dtx b/l3pdffield-choice.dtx
index 81047df..c633263 100644
--- a/l3pdffield-choice.dtx
+++ b/l3pdffield-choice.dtx
@@ -2,7 +2,7 @@
%
%% File: l3pdfpdffield-choice.dtx
%
-% Copyright (C) 2021 The LaTeX Project
+% Copyright (C) 2021-2022 The LaTeX Project
%
% It may be distributed and/or modified under the conditions of the
% LaTeX Project Public License (LPPL), either version 1.3c of this
@@ -24,7 +24,7 @@
%
%<*driver>
\RequirePackage{pdfmanagement-testphase}
-\DeclareDocumentMetadata{}
+\DocumentMetadata{}
\makeatletter
\declare at file@substitution{doc.sty}{doc-v3beta.sty}
\makeatother
diff --git a/l3pdffield-pushbutton.dtx b/l3pdffield-pushbutton.dtx
index 0045b14..531afa0 100644
--- a/l3pdffield-pushbutton.dtx
+++ b/l3pdffield-pushbutton.dtx
@@ -2,7 +2,7 @@
%
%% File: l3pdfpdffield-pushbutton.dtx
%
-% Copyright (C) 2021 The LaTeX Project
+% Copyright (C) 2021-2022 The LaTeX Project
%
% It may be distributed and/or modified under the conditions of the
% LaTeX Project Public License (LPPL), either version 1.3c of this
@@ -24,7 +24,7 @@
%
%<*driver>
\RequirePackage{pdfmanagement-testphase}
-\DeclareDocumentMetadata{}
+\DocumentMetadata{}
\makeatletter
\declare at file@substitution{doc.sty}{doc-v3beta.sty}
\makeatother
diff --git a/l3pdffield-radiobutton.dtx b/l3pdffield-radiobutton.dtx
index 45f6a35..ae10fd5 100644
--- a/l3pdffield-radiobutton.dtx
+++ b/l3pdffield-radiobutton.dtx
@@ -2,7 +2,7 @@
%
%% File: l3pdfpdffield-radiobutton.dtx
%
-% Copyright (C) 2021 The LaTeX Project
+% Copyright (C) 2021-2022 The LaTeX Project
%
% It may be distributed and/or modified under the conditions of the
% LaTeX Project Public License (LPPL), either version 1.3c of this
@@ -24,7 +24,7 @@
%
%<*driver>
\RequirePackage{pdfmanagement-testphase}
-\DeclareDocumentMetadata{}
+\DocumentMetadata{}
\makeatletter
\declare at file@substitution{doc.sty}{doc-v3beta.sty}
\makeatother
diff --git a/l3pdffield-textfield.dtx b/l3pdffield-textfield.dtx
index 792b7df..b5c0ed1 100644
--- a/l3pdffield-textfield.dtx
+++ b/l3pdffield-textfield.dtx
@@ -2,7 +2,7 @@
%
%% File: l3pdfpdffield-textfield.dtx
%
-% Copyright (C) 2021 The LaTeX Project
+% Copyright (C) 2021-2022 The LaTeX Project
%
% It may be distributed and/or modified under the conditions of the
% LaTeX Project Public License (LPPL), either version 1.3c of this
@@ -24,7 +24,7 @@
%
%<*driver>
\RequirePackage{pdfmanagement-testphase}
-\DeclareDocumentMetadata{}
+\DocumentMetadata{}
\makeatletter
\declare at file@substitution{doc.sty}{doc-v3beta.sty}
\makeatother
diff --git a/l3pdffield.dtx b/l3pdffield.dtx
index d7b2b40..6349998 100644
--- a/l3pdffield.dtx
+++ b/l3pdffield.dtx
@@ -2,7 +2,7 @@
%
%% File: l3pdffield.dtx
%
-% Copyright (C) 2021 The LaTeX Project
+% Copyright (C) 2021-2022 The LaTeX Project
%
% It may be distributed and/or modified under the conditions of the
% LaTeX Project Public License (LPPL), either version 1.3c of this
@@ -24,7 +24,7 @@
%
%<*driver>
\RequirePackage{pdfmanagement-testphase}
-\DeclareDocumentMetadata{}
+\DocumentMetadata{}
\makeatletter
\declare at file@substitution{doc.sty}{doc-v3beta.sty}
\makeatother
@@ -139,7 +139,7 @@
%
% \begin{verbatim}
% \RequirePackage{pdfmanagement-testphase}
-% \DeclareDocumentMetadata{uncompress}
+% \DocumentMetadata{uncompress}
% \documentclass{article}
% \usepackage{hyperref}
% \usepackage{l3pdffield-testphase}
diff --git a/l3pdffile.dtx b/l3pdffile.dtx
index ade92cf..b00f2dc 100644
--- a/l3pdffile.dtx
+++ b/l3pdffile.dtx
@@ -2,7 +2,7 @@
%
%% File: l3pdffile.dtx
%
-% Copyright (C) 2018-2021 The LaTeX Project
+% Copyright (C) 2018-2022 The LaTeX Project
%
% It may be distributed and/or modified under the conditions of the
% LaTeX Project Public License (LPPL), either version 1.3c of this
@@ -24,7 +24,7 @@
%
%<*driver>
\RequirePackage{pdfmanagement-testphase}
-\DeclareDocumentMetadata{pdfstandard=A-2b}
+\DocumentMetadata{pdfstandard=A-2b}
\makeatletter
\declare at file@substitution{doc.sty}{doc-v3beta.sty}
\makeatother
diff --git a/l3pdfmanagement.dtx b/l3pdfmanagement.dtx
index 7cb4bf4..30edbad 100644
--- a/l3pdfmanagement.dtx
+++ b/l3pdfmanagement.dtx
@@ -2,7 +2,7 @@
%
%% File: l3pdfmanagement.dtx
%
-% Copyright (C) 2018-2021 The LaTeX Project
+% Copyright (C) 2018-2022 The LaTeX Project
%
% It may be distributed and/or modified under the conditions of the
% LaTeX Project Public License (LPPL), either version 1.3c of this
@@ -24,7 +24,7 @@
%
%<*driver>
\RequirePackage{pdfmanagement-testphase}
-\DeclareDocumentMetadata{pdfstandard=A-2b}
+\DocumentMetadata{pdfstandard=A-2b}
\makeatletter
\declare at file@substitution{doc.sty}{doc-v3beta.sty}
\makeatother
@@ -674,7 +674,7 @@
% \begin{variable}{\g_@@_active_bool}
% This boolean will control the activation of the management code.
% It is used in the hooks, and in some backend files.
-% % \cs{DeclareDocumentMetadata} should set it to true
+% % \cs{DocumentMetadata} should set it to true
% \begin{macrocode}
\bool_new:N \g_@@_active_bool
% \end{macrocode}
diff --git a/l3pdfmeta.dtx b/l3pdfmeta.dtx
index 7bcd082..15e871a 100644
--- a/l3pdfmeta.dtx
+++ b/l3pdfmeta.dtx
@@ -2,7 +2,7 @@
%
%% File: l3pdfmeta.dtx
%
-% Copyright (C) 2018-2021 The LaTeX Project
+% Copyright (C) 2018-2022 The LaTeX Project
%
% It may be distributed and/or modified under the conditions of the
% LaTeX Project Public License (LPPL), either version 1.3c of this
@@ -24,7 +24,7 @@
%
%<*driver>
\RequirePackage{pdfmanagement-testphase}
-\DeclareDocumentMetadata{pdfstandard=A-2b}
+\DocumentMetadata{pdfstandard=A-2b}
\makeatletter
\declare at file@substitution{doc.sty}{doc-v3beta.sty}
\makeatother
@@ -192,7 +192,7 @@
% reference it in a /Outputintent and that all output intents reference
% the same colorprofile. The value stores the subtype.
% {\em This requirement is detected and fulfilled by \pkg{l3pdfmeta} if the
-% provided interface in \cs{DeclareDocumentMetadata} is used, see below}.
+% provided interface in \cs{DocumentMetadata} is used, see below}.
%
% \item[|annot_flags|] in annotations the |Print| flag should be true,
% |Hidden|, |Invisible|, |NoView| should be false.
@@ -235,7 +235,7 @@
% 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{DeclareDocumentMetadata} so more checks are only needed if the version is changed later.
+% \cs{DocumentMetadata} so 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|.
@@ -290,7 +290,7 @@
% The interface looks like this
%
% \begin{verbatim}
-% \DeclareDocumentMetadata
+% \DocumentMetadata
% {
% %other options for example pdfstandard
% colorprofiles=
@@ -318,7 +318,7 @@
% color profile, the setting is changed to the equivalent of
%
% \begin{verbatim}
-% \DeclareDocumentMetadata
+% \DocumentMetadata
% {
% %other options
% pdfstandard=A-2b,
diff --git a/l3pdftools.dtx b/l3pdftools.dtx
index 4b35e21..f0ff9f8 100644
--- a/l3pdftools.dtx
+++ b/l3pdftools.dtx
@@ -2,7 +2,7 @@
%
%% File: l3pdftools.dtx
%
-% Copyright (C) 2018-2021 The LaTeX Project
+% Copyright (C) 2018-2022 The LaTeX Project
%
% It may be distributed and/or modified under the conditions of the
% LaTeX Project Public License (LPPL), either version 1.3c of this
@@ -24,7 +24,7 @@
%
%<*driver>
\RequirePackage{pdfmanagement-testphase}
-\DeclareDocumentMetadata{pdfstandard=A-2b}
+\DocumentMetadata{pdfstandard=A-2b}
\makeatletter
\declare at file@substitution{doc.sty}{doc-v3beta.sty}
\makeatother
diff --git a/l3pdfxform.dtx b/l3pdfxform.dtx
index 86ecfcc..cdde840 100644
--- a/l3pdfxform.dtx
+++ b/l3pdfxform.dtx
@@ -2,7 +2,7 @@
%
%% File: l3pdfxform.dtx
%
-% Copyright (C) 2018-2021 The LaTeX Project
+% Copyright (C) 2018-2022 The LaTeX Project
%
% It may be distributed and/or modified under the conditions of the
% LaTeX Project Public License (LPPL), either version 1.3c of this
@@ -24,7 +24,7 @@
%
%<*driver>
\RequirePackage{pdfmanagement-testphase}
-\DeclareDocumentMetadata{pdfstandard=A-2b}
+\DocumentMetadata{pdfstandard=A-2b}
\makeatletter
\declare at file@substitution{doc.sty}{doc-v3beta.sty}
\makeatother
diff --git a/ltdocinit.dtx b/ltdocinit.dtx
index e68f877..6ee89bb 100644
--- a/ltdocinit.dtx
+++ b/ltdocinit.dtx
@@ -2,7 +2,7 @@
%
%% File: ltdocinit.dtx
%
-% Copyright (C) 2018-2021 The LaTeX Project
+% Copyright (C) 2018-2022 The LaTeX Project
%
% It may be distributed and/or modified under the conditions of the
% LaTeX Project Public License (LPPL), either version 1.3c of this
@@ -24,7 +24,7 @@
%
%<*driver>
\RequirePackage{pdfmanagement-testphase}
-\DeclareDocumentMetadata{pdfstandard=A-2b}
+\DocumentMetadata{pdfstandard=A-2b}
\makeatletter
\declare at file@substitution{doc.sty}{doc-v3beta.sty}
\makeatother
diff --git a/ltdocinit.pdf b/ltdocinit.pdf
index 1bc3aa2..325f211 100644
Binary files a/ltdocinit.pdf and b/ltdocinit.pdf differ
diff --git a/pdfmanagement-firstaid.dtx b/pdfmanagement-firstaid.dtx
index 95665b9..237c874 100644
--- a/pdfmanagement-firstaid.dtx
+++ b/pdfmanagement-firstaid.dtx
@@ -2,7 +2,7 @@
%
%% File: pdfmanagement-firstaid.dtx
%
-% Copyright (C) 2018-2021 The LaTeX Project
+% Copyright (C) 2018-2022 The LaTeX Project
%
% It may be distributed and/or modified under the conditions of the
% LaTeX Project Public License (LPPL), either version 1.3c of this
@@ -24,7 +24,7 @@
%
%<*driver>
\RequirePackage{pdfmanagement-testphase}
-\DeclareDocumentMetadata{pdfstandard=A-2b}
+\DocumentMetadata{pdfstandard=A-2b}
\makeatletter
\declare at file@substitution{doc.sty}{doc-v3beta.sty}
\makeatother
@@ -63,8 +63,8 @@
% This code should disappear when packages adapt to the central interfaces.
%
% The package contains an number of sections for various packages. Every
-% section can be disabled in (the first) \cs{DeclareDocumentMetadata} with
-% |firstaidoff={name1,name2,...}|.
+% section can be disabled in (the first) \cs{DocumentMetadata} with
+% |debug={firstaidoff={name1,name2,...},...}|.
% \begin{macrocode}
%<*package>
\ProvidesExplPackage{pdfmanagement-firstaid}{2021-08-28}{0.95i}
diff --git a/pdfmanagement-testphase.dtx b/pdfmanagement-testphase.dtx
index b3e271e..124789a 100644
--- a/pdfmanagement-testphase.dtx
+++ b/pdfmanagement-testphase.dtx
@@ -2,7 +2,7 @@
%
%% File: pdfmanagement-testphase.dtx
%
-% Copyright (C) 2019-2021 The LaTeX Project
+% Copyright (C) 2019-2022 The LaTeX Project
%
% It may be distributed and/or modified under the conditions of the
% LaTeX Project Public License (LPPL), either version 1.3c of this
@@ -24,7 +24,7 @@
%
%<*driver>
\RequirePackage{pdfmanagement-testphase}
-\DeclareDocumentMetadata{pdfstandard=A-2b}
+\DocumentMetadata{pdfstandard=A-2b}
\makeatletter
%\declare at file@substitution{doc.sty}{doc-v3beta.sty}
\makeatother
@@ -66,7 +66,7 @@
% \begin{verbatim}
% \RequirePackage{pdfmanagement-testphase} % load the package
%
-% \DeclareDocumentMetadata % activate the PDF management (with options)
+% \DocumentMetadata % activate the PDF management (with options)
% {
% % options
% }
@@ -76,6 +76,8 @@
% Note that the activation has to happen before the \cs{documentclass} declaration.
% Because of this, the package needs loading with \cs{RequirePackage}.
%
+% Starting with LaTeX 2022-06-01 (or a suitable latex-dev) it is no longer necessary to
+% load pdfmanagement-testphase manually, using \cs{DocumentMetadata} is enough.
%
%
% \section*{Feedback wanted!}
@@ -172,7 +174,7 @@
%
% Loading the package will only \emph{load} the modules,
% to \emph{activate} the core PDF management the trigger command
-% \cs{DeclareDocumentMetadata} has to be used too.
+% \cs{DocumentMetadata} has to be used too.
% The loading and activation has to be done
% \emph{before} the \cs{documentclass} command.
%
@@ -202,22 +204,24 @@
% \section{Use}\label{sec:use}
% The package should be loaded before \cs{documentclass}. To activate
% the resource management it should be followed by
-% \cs{DeclareDocumentMetadata}\marg{key-val}.
-% The options of \cs{DeclareDocumentMetadata} are described in the documentation of
+% \cs{DocumentMetadata}\marg{key-val}.
+% The options of \cs{DocumentMetadata} are described in the documentation of
% \pkg{ltdocinit}.
%
% \begin{verbatim}
% \RequirePackage{pdfmanagement-testphase} % load the package
-% \DeclareDocumentMetadata % activates the PDF management interface
+% % not needed with LaTeX 2022-06-01
+% \DocumentMetadata % activates the PDF management interface
% {
% %options
% }
% \documentclass {...}
% \end{verbatim}
%
-% The PDF management can be deactivated either setting the key
+% The PDF management can be deactivated either setting in the \texttt{debug} key
+% the key
% \texttt{pdfmanagement} to \texttt{false} or by commenting out
-% the whole \cs{DeclareDocumentMetadata} declaration.
+% the whole \cs{DocumentMetadata} declaration.
%
% To test if the PDF management is active the predicate
% \cs{pdfmanagement_if_active:TF} can be used, see the documentation of \pkg{l3pdfmanagement}.
@@ -251,7 +255,7 @@
%
% \item[l3pdfmanagement] This is the core code of the PDF management.
%
-% \item[ltdocinit] This module provides the \cs{DeclareDocumentMetadata} command.
+% \item[ltdocinit] This module provides the \cs{DocumentMetadata} command.
%
% \item[hyperref-generic] This module provides a new generic hyperref driver.
% The driver will
@@ -333,23 +337,23 @@
% Some patch code is provided by the bundle and loaded automatically,
% but it is not complete currently. Failures are e.g. possible with complicated
% author or title settings. The handling of dates isn't correct either yet.
-% The patch code can be disabled by using |firstaidoff=hyperxmp| in \cs{DeclareDocumentMetadata}
+% The patch code can be disabled by using |debug={firstaidoff=hyperxmp}| in \cs{DocumentMetadata}
%
% \subsection{tikz/pgf}
% \pkg{pgf} writes to the page resources too and so is incompatible. The needed
% changes are rather small and will be done in coordination with the maintainer.
% Until this works, \pkg{pagemanagement} will load the patches automatically.
-% This can be disabled by using |firstaidoff=pgf| in \cs{DeclareDocumentMetadata}
+% This can be disabled by using |debug={firstaidoff=pgf}| in \cs{DocumentMetadata}
%
% \subsection{transparent}
% The package \pkg{transparent} is incompatible. A replacement has been written
% (\pkg{transparent-ltx}) and is loaded automatically. It requires a very recent
% L3 programming layer!
-% This can be disabled by using |firstaidoff=transparent| in \cs{DeclareDocumentMetadata}
+% This can be disabled by using |debug={firstaidoff=transparent}| in \cs{DocumentMetadata}
% \subsection{pdflscape}
% The package \pkg{pdflscape} is incompatible. A replacement has been written
% (\pkg{pdflscape-ltx}) and is loaded automatically.
-% This can be disabled by using |firstaidoff=pdflscape| in \cs{DeclareDocumentMetadata}
+% This can be disabled by using |debug={firstaidoff=pdflscape}| in \cs{DocumentMetadata}
%
% \subsection{colorspace}
% The package is incompatible. Some patches
@@ -394,6 +398,7 @@
\MessageBreak Loading~is~aborted.}{}
\DeclareOption { debug }{}
\newcommand\DeclareDocumentMetadata[1]{}
+ \newcommand\DocumentMetadata[1]{}
\ProcessOptions\relax
}
\IfFormatAtLeastTF{2020-10-01}{}{\endinput}
@@ -418,7 +423,7 @@
%<*package>
%\RequirePackage{l3pdfdict} % needed by l3pdfmanagement
%\RequirePackage{l3pdfmanagement} % loads the core code with the boolean
-%\RequirePackage{ltdocinit} % DeclareDocumentMetadata,
+%\RequirePackage{ltdocinit} % DocumentMetadata,
%% can perhaps be combined or made optional ...
%\RequirePackage{l3pdfannot}
%\RequirePackage{l3pdfxform-beta}
More information about the latex3-commits
mailing list.