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.dtx72
1 files changed, 37 insertions, 35 deletions
diff --git a/Master/texmf-dist/source/latex/l3kernel/l3drivers.dtx b/Master/texmf-dist/source/latex/l3kernel/l3drivers.dtx
index d2449c5cb94..5cf76d9b972 100644
--- a/Master/texmf-dist/source/latex/l3kernel/l3drivers.dtx
+++ b/Master/texmf-dist/source/latex/l3kernel/l3drivers.dtx
@@ -1,5 +1,5 @@
% \iffalse meta-comment
-%
+%
%% File: l3drivers.dtx Copyright(C) 2011 The LaTeX3 Project
%%
%% It may be distributed and/or modified under the conditions of the
@@ -36,7 +36,7 @@
%
%<*driver>
\RequirePackage{l3names}
-\GetIdInfo$Id: l3drivers.dtx 2717 2011-09-03 13:40:31Z joseph $
+\GetIdInfo$Id: l3drivers.dtx 2776 2011-09-07 18:33:19Z joseph $
{L3 Experimental drivers}
%</driver>
%<*driver>
@@ -46,13 +46,13 @@
\end{document}
%</driver>
% \fi
-%
+%
% \title{^^A
% The \textsf{l3drivers} package\\ Drivers^^A
% \thanks{This file describes v\ExplFileVersion,
% last revised \ExplFileDate.}^^A
% }
-%
+%
% \author{^^A
% The \LaTeX3 Project\thanks
% {^^A
@@ -67,7 +67,7 @@
% \maketitle
%
% \begin{documentation}
-%
+%
% \TeX{} relies on drivers in order to carry out a number of tasks, such
% as using colour, including graphics and setting up hyper-links. The nature
% of the code required depends on the exact driver in use. Currently,
@@ -80,16 +80,17 @@
% \pdfTeX{} or \LuaTeX{} in DVI mode.
% \item \texttt{xdvipdfmx}: The driver used by \XeTeX{}.
% \end{itemize}
-%
+%
% The code here is all very low-level, and should not in general be used
% outside of the kernel. It is also important to note that many of the
% functions here are closely tied to the immediate level \enquote{up}:
% several variable values must be in the correct locations for the driver
% code to function.
-%
+%
% \section{Box rotation and scaling}
-%
-% \begin{function}{\driver_box_rotate_begin:, \driver_box_rotate_end:}
+%
+% \begin{function}[added = 2011-09-01]
+% {\driver_box_rotate_begin:, \driver_box_rotate_end:}
% \begin{syntax}
% \cs{driver_box_rotate_begin:}
% \cs{box_use:N} \cs{l_box_tmp_box}
@@ -103,8 +104,9 @@
% and end markers will be stored in \cs{l_box_tmp_box}: this fact is
% required by some drivers to obtain the correct output.
% \end{function}
-%
-% \begin{function}{\driver_box_scale_begin:, \driver_box_scale_end:}
+%
+% \begin{function}[added = 2011-09-02]
+% {\driver_box_scale_begin:, \driver_box_scale_end:}
% \begin{syntax}
% \cs{driver_box_scale_begin:}
% \meta{box material}
@@ -118,32 +120,32 @@
% supported and so the higher-level code must convert the absolute sizes
% to scale factors.
% \end{function}
-%
+%
% \section{Colour support}
-%
-% \begin{function}{\driver_color_ensure_current:}
+%
+% \begin{function}[added = 2011-09-03]{\driver_color_ensure_current:}
% \begin{syntax}
% \cs{driver_color_ensure_current:}
% \end{syntax}
% Ensures that the colour used to typeset material is that which was
% set when the material was placed in a box. This function is therefore
% required inside any \enquote{colour safe} box to ensure that the box may
-% be inserted in a location where the foreground colour has been altered,
+% be inserted in a location where the foreground colour has been altered,
% while preserving the colour used in the box.
% \end{function}
-%
+%
% \end{documentation}
%
% \begin{implementation}
%
% \section{\pkg{l3drivers} Implementation}
-%
+%
% \begin{macrocode}
%<*initex>
% \end{macrocode}
-%
+%
% \subsection{Settings for direct PDF output}
-%
+%
% If the driver loaded is \texttt{pdfmode} then direct PDF output is required.
% (This may of course alter: it might be that the driver is picked based on the
% value of \cs{pdfmode_pdfoutput:D}.)
@@ -168,7 +170,7 @@
\pdftex_pdfobjcompresslevel:D = 2 \scan_stop:
%</pdfmode>
% \end{macrocode}
-%
+%
% \subsection{Box rotation and scaling}
%
% \begin{variable}{\l_driver_box_matrix_tl}
@@ -179,7 +181,7 @@
%</pdfmode>
% \end{macrocode}
% \end{variable}
-%
+%
% \begin{variable}{\l_driver_tmp_fp}
% Needed for a safe sign inversion in PDF mode.
% \begin{macrocode}
@@ -188,7 +190,7 @@
%</pdfmode>
% \end{macrocode}
% \end{variable}
-%
+%
% \begin{macro}{\driver_box_rotate_begin:, \driver_box_rotate_end:}
% Systems which require only the rotation angle have simple drivers.
% On the other hand, in PDF mode the affine transformation matrix is
@@ -210,10 +212,10 @@
%</dvips>
%<*pdfmode>
\fp_set_eq:NN \l_driver_tmp_fp \l_box_sin_fp
- \fp_neg:N \l_driver_tmp_fp
+ \fp_neg:N \l_driver_tmp_fp
\tl_set:Nx \l_driver_box_matrix_tl
- {
- \fp_use:N \l_box_cos_fp \c_space_tl
+ {
+ \fp_use:N \l_box_cos_fp \c_space_tl
\fp_use:N \l_box_sin_fp \c_space_tl
\fp_use:N \l_driver_tmp_fp \c_space_tl
\fp_use:N \l_box_cos_fp
@@ -242,10 +244,10 @@
%</xdvipdfmx>
% \end{macrocode}
% \end{macro}
-%
+%
% \begin{macro}{\driver_box_scale_begin:, \driver_box_scale_end:}
% Scaling is not dissimilar to rotation, but the calculations are somewhat
-% less complex.
+% less complex.
% \begin{macrocode}
\cs_new_protected_nopar:Npn \driver_box_scale_begin:
{
@@ -262,8 +264,8 @@
%</dvips>
%<*pdfmode>
\tl_set:Nx \l_driver_box_matrix_tl
- {
- \fp_use:N \l_box_scale_x_fp \c_space_tl
+ {
+ \fp_use:N \l_box_scale_x_fp \c_space_tl
0 ~ 0 ~
\fp_use:N \l_box_scale_y_fp
}
@@ -293,7 +295,7 @@
1~\fp_use:N \l_box_scale_y_fp \c_space_tl div~
scale~neg~exch~neg~exch~
translate
- }
+ }
}
%</dvips>
%<*pdfmode>
@@ -304,9 +306,9 @@
%</xdvipdfmx>
% \end{macrocode}
% \end{macro}
-%
+%
% \subsection{Colour support}
-%
+%
% \begin{variable}{\l_driver_current_color_tl}
% The current colour is needed by all of the engines, but the way this
% is stored varies.
@@ -333,13 +335,13 @@
%</pdfmode>
% \end{macrocode}
% \end{variable}
-%
+%
% \begin{macro}{\driver_color_group_begin:, \driver_color_group_end:}
% \begin{macrocode}
% \end{macrocode}
% \end{macro}
-%
+%
% \begin{macro}{\driver_color_ensure_current:}
% \begin{macro}[aux]{\driver_color_reset:}
% Setting the current colour depends on the nature of the colour stack
@@ -374,4 +376,4 @@
%
% \end{implementation}
%
-% \PrintIndex \ No newline at end of file
+% \PrintIndex