add dummies for linktarget interface

latex3 · May 10, 2022 · 575c112 · 575c112
1 parent 7a4a216
commit 575c112
Show file tree

Hide file tree

Showing 3 changed files with 47 additions and 10 deletions.
diff --git 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@latex-project.org>
+
+	* ltfinal.dtx:
+	Added dummy definitions for target commands.
+
 2022-05-08  Marcel Krüger  <Marcel.Krueger@latex-project.org>
 
   * utf8ienc.dtx:

diff --git a/base/doc/ltnews35.tex b/base/doc/ltnews35.tex
@@ -183,6 +183,9 @@ \section{Document metadata interface}
 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 @@ \subsection{Starred command version for \cs{ref}, \cs{Ref} and \cs{pageref}}
 \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
@@ -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}
@@ -154,7 +154,7 @@
 % \end{macro}
 %
 %
-%    
+%
 %    Allocate 3 mark classes to be used in \cs{markboth} and
 %    \cs{markright}. Should be done earlier but for that definition of
 %    \cs{newmarks} needs moving (which it should I guess).
@@ -164,8 +164,8 @@
 %<*2ekernel|latexrelease>
 %<latexrelease>\IncludeInRelease{2022/06/01}%
 %<latexrelease>                 {2e-left}{Delayed legacy marks}%
-\NewMarkClass {2e-left}     
-\NewMarkClass {2e-right}     
+\NewMarkClass {2e-left}
+\NewMarkClass {2e-right}
 \NewMarkClass {2e-right-nonempty}
 %    \end{macrocode}
 %    No rollback really, the marks will remain.
@@ -1086,7 +1086,7 @@
 %
 % Two wrappers around the L3 case changing functions.
 % |\protected| to make them mostly safe as replacements for |uppercase|
-% and |\lowercase|.  
+% and |\lowercase|.
 %    \begin{macrocode}
 \ExplSyntaxOn
 \protected\def\@expl@text@lowercase@@n{\text_lowercase:n}
@@ -1300,22 +1300,22 @@
 %    into the kernel but for now it is separate and has to be
 %    explicitly loaded in the document.
 %
-%    In that code there is a command \cs{IfPDFManagementActiveTF} 
-%    which can be used by packages in order to execute different 
+%    In that code there is a command \cs{IfPDFManagementActiveTF}
+%    which can be used by packages in order to execute different
 %    code depending on the whether this basic backend support is loaded.
 %
 %    To make this also work properly when this external package is not
 %    loaded at all, we here add this command already in the
 %    kernel (with a trivial definition); thus any package can
-%    query this loading state in all circumstances.  
+%    query this loading state in all circumstances.
 %    Once this basic PDF backend
 %    support gets moved to the kernel, this definition will vanish
 %    again from here or, rather, it will be replaced by a real test.
 %
 %  \begin{macro}{\IfPDFManagementActiveTF}
-%    So long as the code for the basic backend support for PDF is not 
+%    So long as the code for the basic backend support for PDF is not
 %    loaded, the test that is implicit here will
-%    always return the false branch. 
+%    always return the false branch.
 %    Once this code is loaded, this definition will get
 %    replaced by a real test (as it is then possible that the
 %    management code is either activated or not activated).
@@ -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}
 %