summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/pdfmanagement-testphase/l3pdfannot.dtx
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/source/latex/pdfmanagement-testphase/l3pdfannot.dtx')
-rw-r--r--Master/texmf-dist/source/latex/pdfmanagement-testphase/l3pdfannot.dtx57
1 files changed, 46 insertions, 11 deletions
diff --git a/Master/texmf-dist/source/latex/pdfmanagement-testphase/l3pdfannot.dtx b/Master/texmf-dist/source/latex/pdfmanagement-testphase/l3pdfannot.dtx
index 71ee24f53df..256e3e6dc9b 100644
--- a/Master/texmf-dist/source/latex/pdfmanagement-testphase/l3pdfannot.dtx
+++ b/Master/texmf-dist/source/latex/pdfmanagement-testphase/l3pdfannot.dtx
@@ -52,7 +52,7 @@
% }^^A
% }
%
-% \date{Version 0.95b, released 2021-02-21}
+% \date{Version 0.95c, released 2021-03-17}
%
% \maketitle
% \begin{documentation}
@@ -163,7 +163,8 @@
% \texttt{Launch}, \texttt{GoTo} or \texttt{Named}. The dictionary can be changed
% by the commands \cs{pdfannot_dict_put:nnn} and friends described below.
% \end{variable}
-% \begin{function}[added = 2020-03-12, updated = 2020-12-06]{ \pdfannot_link:nnn }
+% \begin{function}[added = 2020-03-12, updated = 2020-12-06]
+% { \pdfannot_link:nnn,\pdfannot_link:nxn }
% \begin{syntax}
% \cs{pdfannot_link:nnn} \Arg{type} \Arg{user action spec} \Arg{link text}
% \end{syntax}
@@ -191,22 +192,56 @@
% text. None of the hooks introduce a group.
% \meta{type} should normally be identical to the value of the |/S| key
% in the action dictionary.
-% As example
+% As example either with a direct action
% \begin{verbatim}
+% \pdfannot_link:nnn { URI }
+% {
+% /A<<
+% /Type/Action
+% /S/URI
+% /URI(https://www.latex-project.org)
+% >>
+% }
+% { link text}
+% \end{verbatim}
+% Or through a dictionary:
+% \begin{verbatim}
+% \pdfdict_new:n {l_my_action_dict}
+% \pdfdict_put:nnn {l_my_action_dict}{Type}{/Action}
+% \pdfdict_put:nnn {l_my_action_dict}{S}{/URI}
+% \pdfdict_put:nnn {l_my_action_dict}{URI}{(https://www.latex-project.org)}
+%
% \pdfannot_dict_put:nnn
% {link/URI} { C } {[1~0~0]} %red border
-% \pdfannot_link:nnn { URI }
+%
+% \pdfannot_link:nxn { URI }
% {
-% /A
-% <<
-% /Type/Action
-% /S/URI
-% /URI(https://www.latex-project.org)
-% >>
+% /A <<\pdfdict_use:n{l_my_action_dict}>>
% }
% { link text }
% \end{verbatim}
%
+% Or if you want to exclude the possibility of a duplicated /A entry
+% (if the action is already in the link/GoTo dictionary e.g. if you can expect
+% other packages to add a dictionary). An alternative is to ensure that
+% no /A is there by removing it explicitly.
+%
+% \begin{verbatim}
+% \pdfdict_new:n {l_my_action_dict}
+% \pdfdict_put:nnn {l_my_action_dict}{Type}{/Action}
+% \pdfdict_put:nnn {l_my_action_dict}{S}{/URI}
+% \pdfdict_put:nnn {l_my_action_dict}{URI}{(https://www.latex-project.org)}
+%
+%
+% \pdfannot_dict_put:nnn
+% {link/URI} { C } {[1~0~0]} %red border
+%
+% \group_begin:
+% \pdfannot_dict_put:nnx {link/GoTo}{A}{<<\pdfdict_use:n{l_my_action_dict}>>}
+% \pdfannot_link:nnn { URI }{}{ link text }
+% \group_end:
+% \end{verbatim}
+%
%
% \end{function}
% \begin{function}[updated = 2020-12-06]{ \pdfannot_link_begin:nnw, \pdfannot_link_end:n }
@@ -357,7 +392,7 @@
% \begin{macrocode}
%<@@=pdfannot>
%<*header>
-\ProvidesExplPackage {l3pdfannot} {2021-03-07} {0.95b}
+\ProvidesExplPackage{l3pdfannot}{2021-03-17}{0.95c}
{PDF-annotations}
\RequirePackage{l3pdfdict}
%</header>