[latex3-commits] [git/LaTeX3-latex3-pdfresources] splitting: start to move template dictionaries (26218f7)

[Ulrike Fischer]

Repository : https://github.com/latex3/pdfresources
On branch  : splitting
Link       : https://github.com/latex3/pdfresources/commit/26218f7f5ec29883b9e27a6bcb6eeed8be0461c1

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

commit 26218f7f5ec29883b9e27a6bcb6eeed8be0461c1
Author: Ulrike Fischer <fischer at troubleshooting-tex.de>
Date:   Tue Jun 16 14:20:42 2020 +0200

    start to move template dictionaries


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

26218f7f5ec29883b9e27a6bcb6eeed8be0461c1
 l3pdfdict.dtx    | 37 ++++++++++++++++++++++++++++---------
 pdfresources.dtx | 22 ----------------------
 2 files changed, 28 insertions(+), 31 deletions(-)

diff --git a/l3pdfdict.dtx b/l3pdfdict.dtx
index caef38e..b9eaf1d 100644
--- a/l3pdfdict.dtx
+++ b/l3pdfdict.dtx
@@ -157,7 +157,7 @@
 %   dictionary doesn't exist.
 % \end{function}
 % \begin{function}[added = 2020-04-07]
-%   {\pdfdict_get:nn \pdfdict_gget:nn  }
+%   {\pdfdict_get:nn, \pdfdict_gget:nn  }
 %   \begin{syntax}
 %     \cs{pdfdict_get:nnN}  \Arg{local dictionary}  \Arg{name} \meta{tl var}\\
 %     \cs{pdfdict_gget:nnN} \Arg{global dictionary} \Arg{name} \meta{tl var}
@@ -201,20 +201,26 @@
 %   escaping. It does nothing if \Arg{value} is empty.
 % \end{function}
 % \subsection{Predeclared dictionaries}
-% The Module predeclares a number of dictionaries and fills them with
-% some standard values. This dictionaries can be used and copied.
+% The module predeclares a number of dictionaries and fills them with
+% some standard values. These dictionaries are meant has templates. They can
+% be changed and used directly but this should be done only inside
+% groups when no other code is involved which tries to change them too.
 % \begin{NOTE}{UF}
 % Check which (local) dictionaries should be predefined.
 % Check also if the reset idea makes sense. (Removed for now)
 % The following tabular summarize the dictionaries
 %
-% \begin{tabular}{lll}
-%  xform\ldots                           & argument of \cs{pdfxform} &local\\
-%  annot\ldots                           & argument of \cs{pdfannot},
-%                                          \cs{pdfstartlink} &local\\
-%  trans                                 & for transitions (used in hyperref)
-%  \end{tabular}
 % \end{NOTE}
+%
+% \medskip
+% \noindent
+% \begin{tabular}{p{\dimexpr0.25\textwidth-6\tabcolsep}p{0.25\textwidth}>{\raggedright}p{0.5\textwidth}}
+%  name      & default keys & notes \tabularnewline\hline
+%  page/Trans& /Type /Trans & for transitions dictionaries. Other keys:
+%                   /S (name), /D integer, /Dm (name),
+%                   /M (name), /SS number /B boolean.
+%  \end{tabular}
+
 % \end{documentation}
 %
 % \begin{implementation}
@@ -372,6 +378,7 @@
 \cs_set_eq:NN \pdfdict_gset_eq:nn \@@_gset_eq:nn
 %</package>
 %    \end{macrocode}
+% \end{macro}
 % \begin{macro}
 %   {
 %     \@@_if_exist:n,  \pdfdict_if_exist:n,
@@ -673,6 +680,18 @@
 %</package>
 %    \end{macrocode}
 % \end{macro}
+% \subsection{Predeclared dictionaries}
+% \begin{variable}{page/Trans}
+%     \begin{macrocode}
+%<*package>
+\pdfdict_new:n {page/Trans}
+\pdfdict_put:nnn {page/Trans}{Type}{/Trans}
+% keys: /S (name), /D integer, /Dm (name), /M (name), /SS number /B boolean.
+% decribes transition *to* the page.
+%</package>
+%    \end{macrocode}
+% \end{variable}
+
 % \end{implementation}
 %
 % \PrintIndex
diff --git a/pdfresources.dtx b/pdfresources.dtx
index aa07efc..2d8ccc5 100644
--- a/pdfresources.dtx
+++ b/pdfresources.dtx
@@ -300,28 +300,6 @@
 %</package>
 %    \end{macrocode}
 %
-% \subsection{Convenience local dictionaries}
-% \begin{NOTE}{UF}
-% This must be reviewed and sorted along with other dictionaries.
-% Perhaps it should move into l3pdfdict.
-% \end{NOTE}
-% A number of predefined small, local dictionaries, that are perhaps needed.
-% \subsubsection{page/Trans}
-% This is a template for a Trans dictionary that can be used in a page dictionary.
-%    \begin{macrocode}
-%<*package>
-\pdfdict_new:n {page/Trans}
-\pdfdict_put:nnn {page/Trans}{Type}{/Trans}
-% keys: /S (name), /D integer, /Dm (name), /M (name), /SS number /B boolean.
-% decribes transition *to* the page.
-%    \end{macrocode}
-% \subsubsection{annot/Link}
-% The dictionaries \texttt{annot/Link/URI}, \texttt{annot/Link/GoToR},
-% \texttt{annot/Link/Launch}, \texttt{annot/Link/GoTo}, \texttt{annot/Link/Named}
-% are created in the pdfannot section \ref{pdf:annot:widget}
-% \subsubsection{annot/Widget}
-% \texttt{annot/Widget} see section \ref{sec:links}.
-%</package>
 % \subsection{The \enquote{Info} dictionary (pdfinfo)}
 % \begin{NOTE}{UF}
 % path: Info