From 66f6e60b6dc60cc08482030b92df223b6a51b15f Mon Sep 17 00:00:00 2001
From: Norbert Preining <norbert@preining.info>
Date: Sun, 29 Aug 2021 03:02:07 +0000
Subject: CTAN sync 202108290302

---
 .../contrib/pdfmanagement-testphase/l3pdfannot.dtx | 24 ++++++++++++++++++++--
 1 file changed, 22 insertions(+), 2 deletions(-)

(limited to 'macros/latex/contrib/pdfmanagement-testphase/l3pdfannot.dtx')

diff --git a/macros/latex/contrib/pdfmanagement-testphase/l3pdfannot.dtx b/macros/latex/contrib/pdfmanagement-testphase/l3pdfannot.dtx
index 8bd41b49c8..03df126efd 100644
--- a/macros/latex/contrib/pdfmanagement-testphase/l3pdfannot.dtx
+++ b/macros/latex/contrib/pdfmanagement-testphase/l3pdfannot.dtx
@@ -52,7 +52,7 @@
 %    }^^A
 % }
 %
-% \date{Version 0.95h, released 2021-07-31}
+% \date{Version 0.95i, released 2021-08-28}
 %
 % \maketitle
 % \begin{documentation}
@@ -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}
@@ -424,7 +436,7 @@
 %    \begin{macrocode}
 %<@@=pdfannot>
 %<*header>
-\ProvidesExplPackage{l3pdfannot}{2021-07-31}{0.95h}
+\ProvidesExplPackage{l3pdfannot}{2021-08-28}{0.95i}
   {PDF-annotations}
 \RequirePackage{l3pdfdict}
 %</header>
@@ -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}
-- 
cgit v1.2.3

