summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/l3kernel/l3drivers.dtx
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/source/latex/l3kernel/l3drivers.dtx')
-rw-r--r--Master/texmf-dist/source/latex/l3kernel/l3drivers.dtx81
1 files changed, 76 insertions, 5 deletions
diff --git a/Master/texmf-dist/source/latex/l3kernel/l3drivers.dtx b/Master/texmf-dist/source/latex/l3kernel/l3drivers.dtx
index 687f8c93dd8..04a731183ae 100644
--- a/Master/texmf-dist/source/latex/l3kernel/l3drivers.dtx
+++ b/Master/texmf-dist/source/latex/l3kernel/l3drivers.dtx
@@ -43,7 +43,7 @@
% }^^A
% }
%
-% \date{Released 2019-04-21}
+% \date{Released 2019-05-03}
%
% \maketitle
%
@@ -439,7 +439,7 @@
%
% \begin{function}{\driver_draw_box_use:Nnnnn}
% \begin{syntax}
-% \cs{driver_draw_box:Nnnnnnn} \meta{box}
+% \cs{driver_draw_box_use:Nnnnn} \meta{box}
% \Arg{a} \Arg{b} \Arg{c} \Arg{d} \Arg{x} \Arg{y}
% \end{syntax}
% Inserts the \meta{box} as an hbox with the box reference point placed
@@ -447,8 +447,9 @@
% to the box, allowing it to be in synchronisation with any scaling, rotation
% or skewing applying more generally. Note that \TeX{} material should not
% be inserted directly into a drawing as it would not be in the correct
-% location. Also note that as for other drawing elements the box here
-% has no size from a \TeX{} perspective.
+% location. Also note that this function must be used inside a box of zero
+% size, shifted appropriately for the correct result; a low-level engine
+% error may result if this is not the case.
% \end{function}
%
% \subsection{Coordinate system transformations}
@@ -492,6 +493,9 @@
% \cs{driver_pdf_link_begin_user:nnw} \Arg{attributes} \Arg{action}
% \Arg{content}
% \cs{driver_pdf_link_end:}
+% \cs{driver_pdf_link_begin_goto:nnw} \Arg{attributes} \Arg{target}
+% \Arg{content}
+% \cs{driver_pdf_link_end:}
% \end{syntax}
% Creates a link of the \meta{type} |goto| or |user| with the given
% \meta{attributes}, points toward the \meta{action} and surround the
@@ -514,7 +518,74 @@
% Sets the length of the margin between content and the border of a link.
% Different back-ends treat the scoping of this value in different ways:
% \pdfTeX{} and \LuaTeX{} treat it as scoped by \TeX{}, whilst with
-% \texttt{dvips} the scope is managed at the PostScript level.
+% \texttt{dvips} the scope is managed at the PostScript level. For
+% \texttt{(x)dvipdfmx}, this setting applies to \emph{all} annotations
+% (\emph{i.e.}~it is global), and thus it may be necessary to set to
+% \texttt{0pt} to avoid breaking for example animations.
+% \end{function}
+%
+% \begin{function}[added = 2019-04-26]{\driver_pdf_destination:nn}
+% \begin{syntax}
+% \cs{driver_pdf_destination:nn} \Arg{name} \Arg{action}
+% \end{syntax}
+% Creates a destination (anchor) called \meta{name}; when a jump is made
+% by a link to the destination, one of the following actions may take
+% place
+% \begin{itemize}
+% \item \texttt{xyz} Move the view such that the target point is at the
+% top-left of the viewer screen
+% \item \texttt{\meta{scale}} As for \texttt{xyz}, but also sets the
+% viewer \meta{scale}
+% \item \texttt{fit} Display the page containing the destination and fit
+% the entire page within the viewer window
+% \item \texttt{fitb} Display the page containing the destination and fit
+% the bounding box of the page within the viewer window
+% \item \texttt{fitbh} Move to the destination page such that the
+% anchor point is at the top of the viewer screen, and scale
+% such that the bounding box fills the viewer width
+% \item \texttt{fitbv} Move to the destination page such that the
+% anchor point is at the left of the viewer screen, and scale
+% such that the bounding box fills the viewer height
+% \item \texttt{fith} Move to the destination page such that the
+% anchor point is at the top of the viewer screen, and scale
+% such that the page fills the viewer width
+% \item \texttt{fitv} Move to the destination page such that the
+% anchor point is at the left of the viewer screen, and scale
+% such that the page fills the viewer height
+% \end{itemize}
+% A \meta{scale} of zero is equivalent to \texttt{xyz}.
+% \end{function}
+%
+% \begin{function}[added = 2019-04-28]{\driver_pdf_destination_rectangle:nn}
+% \begin{syntax}
+% \cs{driver_pdf_destination_rectangle:nn} \Arg{name} \Arg{content}
+% \end{syntax}
+% Creates a destination (anchor) called \meta{name}; when a jump is made
+% by a link to the destination, the viewer will set the zoom such that all
+% of the \meta{content} is visible taking up the full width or height of the
+% viewer area.
+% \end{function}
+%
+% \subsection{PDF Catalogue entries}
+%
+% \begin{function}[added = 2019-04-28]{\driver_pdf_catalog_gput:nn}
+% \begin{syntax}
+% \cs{driver_pdf_catalog_gput:nn} \Arg{key} \Arg{value}
+% \end{syntax}
+% Adds the key--value pair to the PDF catalog. The \meta{key} should
+% be given \emph{without} the leading |/|. The \meta{value} should be
+% a \enquote{raw} PDF dictionary entry, including the |(|/|)| pair for
+% a string, a leading |/| for a boolean, \emph{etc.}
+% \end{function}
+%
+% \begin{function}[added = 2019-04-28]{\driver_pdf_info_gput:nn}
+% \begin{syntax}
+% \cs{driver_pdf_info_gput:nn} \Arg{key} \Arg{value}
+% \end{syntax}
+% Adds the key--value pair to the PDF information. The \meta{key} should
+% be given \emph{without} the leading |/|. The \meta{value} should be
+% a \enquote{raw} PDF dictionary entry, including the |(|/|)| pair for
+% a string or leading |/| for a boolean.
% \end{function}
%
% \subsection{PDF Objects}