[latex3-commits] [git/LaTeX3-latex3-latex2e] makelinktarget: add dummies for linktarget interface (575c1127)

[Ulrike Fischer]

Repository : https://github.com/latex3/latex2e
On branch  : makelinktarget
Link       : https://github.com/latex3/latex2e/commit/575c11270c02b8cee571239c459d1f2eff4b4c63

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

commit 575c11270c02b8cee571239c459d1f2eff4b4c63
Author: Ulrike Fischer <fischer at troubleshooting-tex.de>
Date:   Tue May 10 16:06:28 2022 +0200

    add dummies for linktarget interface


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

575c11270c02b8cee571239c459d1f2eff4b4c63
 base/changes.txt      |  5 +++++
 base/doc/ltnews35.tex | 14 ++++++++++++++
 base/ltfinal.dtx      | 20 +++++++++++++++++++-
 3 files changed, 38 insertions(+), 1 deletion(-)

diff --git a/base/changes.txt b/base/changes.txt
index f1ad2672..2dbde15f 100644
--- a/base/changes.txt
+++ b/base/changes.txt
@@ -5,6 +5,11 @@ It is provided for convenience only.  It therefore makes no claims to
 completeness or accuracy and it contains some references to files that
 are not part of the distribution.
 ================================================================================
+2022-05-10  Ulrike Fischer <Ulrike.Fischer at latex-project.org>
+
+	* ltfinal.dtx:
+	Added dummy definitions for target commands.
+
 2022-05-08  Marcel Krüger  <Marcel.Krueger at latex-project.org>
 
   * utf8ienc.dtx:
diff --git a/base/doc/ltnews35.tex b/base/doc/ltnews35.tex
index aa508ea7..53a86589 100644
--- a/base/doc/ltnews35.tex
+++ b/base/doc/ltnews35.tex
@@ -183,6 +183,9 @@ Documentation about the new command and
 already existing keys are in \file{l3meta.pdf} and \file{documentmetadata-support.pdf}
 and also in the documentation of the \pkg{pdfmanagement-testphase} package.
 
+Package and class authors can test if a user has used \cs{DocumentMetadata}
+and so loaded the pdfmanagement package with \cs{IfPDFManagementActiveTF}. 
+
 
 \section{The \pkg{latex-lab} bundle}
 
@@ -470,7 +473,18 @@ in captions and sectioning commands. The package \pkg{ifthen} has been updated t
 \cs{pageref} can still be used inside tests like \cs{isodd}.
 
 
+\subsection{Preparation for supporting PDF in backends}
 
+At the current point in time, basic support for PDF in
+backends is not part of \LaTeX{} core; it is provided by external
+package like \pkg{hyperref}. 
+At some time in the future that work will be placed
+into the kernel but for now it is separate and has to be
+explicitly loaded in the document. To enable class and package authors
+to support PDF specific task like the creation of link targets without
+having to test first if \pkg{hyperref} has been loaded, dummy versions of
+the commands \cs{MakeLinkTarget}, \cs{LinkTargetOn}, \cs{LinkTargetOff} and
+\cs{NextLinkTarget} are provided. 
 
 \section{Code improvements}
 
diff --git a/base/ltfinal.dtx b/base/ltfinal.dtx
index 5857e6cf..ac483340 100644
--- a/base/ltfinal.dtx
+++ b/base/ltfinal.dtx
@@ -33,7 +33,7 @@
 %<*driver>
 % \fi
 \ProvidesFile{ltfinal.dtx}
-             [2022/04/21 v2.2t LaTeX Kernel (Final Settings)]
+             [2022/05/10 v2.2u LaTeX Kernel (Final Settings)]
 % \iffalse
 \documentclass{ltxdoc}
 \GetFileInfo{ltfinal.dtx}
@@ -1325,7 +1325,25 @@
 %    \end{macrocode}
 %  \end{macro}
 %
+%   To allow package and class author to support for document links
+%   we provide also the new interface commands of the hyperref package
+%   for the creation of targets.
 %
+%  \begin{macro}{\MakeLinkTarget}
+%  \begin{macro}{\LinkTargetOn}
+%  \begin{macro}{\LinkTargetOff}
+%  \begin{macro}{\NextLinkTarget}
+% \changes{v2.2u}{2022/05/10}{Default definition for targets added}
+%    \begin{macrocode}
+\NewDocumentCommand\MakeLinkTarget{sO{}m}{}
+\NewDocumentCommand\LinkTargetOn{}{}
+\NewDocumentCommand\LinkTargetOff{}{}
+\NewDocumentCommand\NextLinkTarget{m}{}
+%    \end{macrocode}
+%  \end{macro}
+%  \end{macro}
+%  \end{macro}
+%  \end{macro}
 %
 % \subsection{Do some temporary work for pre-release}
 %