[latex3-commits] [git/LaTeX3-latex3-pdfresources] develop, outputpatches: changed name, correct typo, added command to l3pdfannot (dee4605)

[Ulrike Fischer]

Repository : https://github.com/latex3/pdfresources
On branches: develop,outputpatches
Link       : https://github.com/latex3/pdfresources/commit/dee4605cf74e0c4978ec322ca36f4c1459f0211d

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

commit dee4605cf74e0c4978ec322ca36f4c1459f0211d
Author: Ulrike Fischer <fischer at troubleshooting-tex.de>
Date:   Thu Aug 19 19:00:26 2021 +0200

    changed name, correct typo, added command to l3pdfannot


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

dee4605cf74e0c4978ec322ca36f4c1459f0211d
 l3backend-testphase.dtx | 16 ++++++++--------
 l3pdfannot.dtx          | 20 ++++++++++++++++++++
 2 files changed, 28 insertions(+), 8 deletions(-)

diff --git a/l3backend-testphase.dtx b/l3backend-testphase.dtx
index 03d2ac6..a314666 100644
--- a/l3backend-testphase.dtx
+++ b/l3backend-testphase.dtx
@@ -1159,17 +1159,17 @@
 % the link. We add here backend support for this.
 %    \begin{macrocode}
 %<*drivers>
-\cs_new_protected:Npn \@@_backend_annotation_linkoff:{}
-\cs_new_protected:Npn \@@_backend_annotation_linkon: {}
+\cs_new_protected:Npn \@@_backend_link_off:{}
+\cs_new_protected:Npn \@@_backend_link_on: {}
 %</drivers>
 %<*pdftex>
 \cs_if_exist:NT \pdfrunninglinkoff
  {
-   \cs_new_protected:Npn \@@_backend_annotation_linkoff:
+   \cs_set_protected:Npn \@@_backend_link_off:
     {
       \pdfrunninglinkoff
     }
-   \cs_new_protected:Npn \@@_backend_annotation_linkon:
+   \cs_set_protected:Npn \@@_backend_link_on:
     {
       \pdfrunninglinkon
     }
@@ -1178,22 +1178,22 @@
 %<*luatex>
 \int_compare:nNnT {\tex_luatexversion:D } > {112}
  {
-   \cs_new_protected:Npn \@@_backend_annotation_linkoff:
+   \cs_set_protected:Npn \@@_backend_link_off:
     {
       \pdfextension linkstate 1
     }
-   \cs_new_protected:Npn \@@_backend_annotation_linkon:
+   \cs_set_protected:Npn \@@_backend_link_on:
     {
       \pdfextension linkstate 0
     }
  }
 %</luatex>
 %<*dvipdfmx|xdvipdfmx>
-  \cs_new_protected:Npn \@@_backend_annotation_linkoff:
+  \cs_set_protected:Npn \@@_backend_link_off:
     {
      \@@_backend:n { nolink }
     }
-   \cs_new_protected:Npn \@@_backend_annotation_linkon:
+   \cs_set_protected:Npn \@@_backend_link_on:
     {
       \@@_backend:n { link }
     }
diff --git a/l3pdfannot.dtx b/l3pdfannot.dtx
index 8bd41b4..e252367 100644
--- a/l3pdfannot.dtx
+++ b/l3pdfannot.dtx
@@ -336,6 +336,18 @@
 %  \end{syntax}
 %   This sets the dimension of the link margin.
 % \end{function}
+%
+% \begin{function}[added=2021-08-19]{\pdfannot_link_off:,\pdfannot_link_on:}
+% In most engines links can broken over lines and pages. The backends then create
+% intermediate link objects to catch all the content between the start and end of
+% the links, mostly based on some heuristics using the boxlevel. This can
+% lead to the unpleasant result that header and footer are part of the link too.
+% Since texlive 2021 pdflatex and lualatex has commands similar to a special already
+% included in dvipdfmx which allows to interrupt a link. The commands must be used
+% with care: typically they must be outside a box that would be catched by link to
+% have the wanted effect.
+%
+% \end{function}
 % \begin{function}[added = 2020-12-04]{ \pdfannot_dict_put:nnn }
 %  \begin{syntax}
 %    \cs{pdfannot_dict_put:nnn} \Arg{dictionary name} \Arg{key} \Arg{value}
@@ -600,6 +612,14 @@
    }
 %    \end{macrocode}
 % \end{variable}
+%
+% \subsection{Interruption of links}
+%    \begin{macrocode}
+\cs_new_protected:Nn \pdfannot_link_off: { \__pdf_backend_link_off: }
+\cs_new_protected:Nn \pdfannot_link_on:  { \__pdf_backend_link_on: }
+%    \end{macrocode}
+%
+%
 % \subsubsection{Annotations, subtype Link /management}
 %
 % \begin{macro}{\pdfannot_link:nnn,\pdfannot_link:nxn}