[latex3-commits] [latex3/pdfresources] develop: update docu (fe0d693)

[github at latex-project.org]

Repository : https://github.com/latex3/pdfresources
On branch  : develop
Link       : https://github.com/latex3/pdfresources/commit/fe0d6938f1e3c1723743df9493ef75bc61ae2920

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

commit fe0d6938f1e3c1723743df9493ef75bc61ae2920
Author: Ulrike Fischer <fischer at troubleshooting-tex.de>
Date:   Mon May 8 10:29:09 2023 +0200

    update docu


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

fe0d6938f1e3c1723743df9493ef75bc61ae2920
 hyperref-generic.dtx        | 17 ++---------------
 l3pdffield.dtx              |  3 +--
 pdfmanagement-testphase.dtx | 23 ++++++++++++++++-------
 3 files changed, 19 insertions(+), 24 deletions(-)

diff --git a/hyperref-generic.dtx b/hyperref-generic.dtx
index 2e67737..db46884 100644
--- a/hyperref-generic.dtx
+++ b/hyperref-generic.dtx
@@ -97,10 +97,9 @@
 % combination should work too.
 %
 % The driver \emph{requires} the new PDF management code, so documents wanting to use it
-% should start like this
+% should start like this (this requires \LaTeX-2022-06-01  or newer):
 % \begin{verbatim}
-% \RequirePackage{pdfmanagement-testphase} %loads the code
-% \DocumentMetadata % activates it
+% \DocumentMetadata %loads the PDF management and activates it
 %   {
 %    %% options
 %    %% e.g. pdf version, backend:
@@ -109,18 +108,6 @@
 %   }
 %  \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
diff --git a/l3pdffield.dtx b/l3pdffield.dtx
index c9181a6..c5c5cb8 100644
--- a/l3pdffield.dtx
+++ b/l3pdffield.dtx
@@ -134,8 +134,7 @@
 % So a typical use together with hyperref could look like this
 %
 % \begin{verbatim}
-% \RequirePackage{pdfmanagement-testphase}
-% \DocumentMetadata{uncompress}
+% \DocumentMetadata{} 
 % \documentclass{article}
 % \usepackage{hyperref}
 % \usepackage{l3pdffield-testphase}
diff --git a/pdfmanagement-testphase.dtx b/pdfmanagement-testphase.dtx
index 15ee3c7..b4fc81f 100644
--- a/pdfmanagement-testphase.dtx
+++ b/pdfmanagement-testphase.dtx
@@ -52,17 +52,29 @@
 % \maketitle
 % \begin{documentation}
 % \section*{Abstract}
-%  {\em This is a temporary package created to allow the manual
+%  {\em This is a temporary bundle created to allow the external
 %   loading of the new \LaTeX{} PDF management code during a test phase.
 %  It will disappear when the code is integrated into the \LaTeX{} format.}
 %
 %  \medskip
-%  \noindent During the test phase the package should be used like this:
+%  \noindent When using \LaTeX-2022-06-01  or newer, the 
+%  PDF management code is loaded if you use \cs{DocumentMetadata} before
+%  \cs{documentclass}. 
 %
 % \begin{verbatim}
-% \RequirePackage{pdfmanagement-testphase}   % load the package
+% \DocumentMetadata      % load activate the PDF management (with options)
+%     {
+%       % options
+%     }
 %
-% \DocumentMetadata      % activate the PDF management (with options)
+%  \documentclass {...}
+% \end{verbatim}
+% 
+% In older \LaTeX{} is has to be loaded explicitly:
+% 
+% \begin{verbatim}
+% \RequirePackage{pdfmanagement-testphase}
+% \DocumentMetadata      % load activate the PDF management (with options)
 %     {
 %       % options
 %     }
@@ -72,9 +84,6 @@
 %  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!}
 %