summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/l3kernel/l3skip.dtx
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/source/latex/l3kernel/l3skip.dtx')
-rw-r--r--Master/texmf-dist/source/latex/l3kernel/l3skip.dtx27
1 files changed, 26 insertions, 1 deletions
diff --git a/Master/texmf-dist/source/latex/l3kernel/l3skip.dtx b/Master/texmf-dist/source/latex/l3kernel/l3skip.dtx
index d82f85327f8..dadd33bfa23 100644
--- a/Master/texmf-dist/source/latex/l3kernel/l3skip.dtx
+++ b/Master/texmf-dist/source/latex/l3kernel/l3skip.dtx
@@ -38,7 +38,7 @@
\documentclass[full]{l3doc}
%</driver>
%<*driver|package>
-\GetIdInfo$Id: l3skip.dtx 5354 2014-08-23 01:35:39Z bruno $
+\GetIdInfo$Id: l3skip.dtx 5607 2015-05-18 12:25:06Z joseph $
{L3 Dimensions and skips}
%</driver|package>
%<*driver>
@@ -473,6 +473,15 @@
% one (\TeX{}) point when converted to big points.
% \end{function}
%
+% \begin{function}[added = 2015-05-18, EXP]{\dim_to_decimal_in_sp:n}
+% \begin{syntax}
+% \cs{dim_to_decimal_in_sp:n} \Arg{dimexpr}
+% \end{syntax}
+% Evaluates the \meta{dimension expression}, and leaves the result,
+% expressed in scaled points (\texttt{sp}) in the input stream, with \emph{no
+% units}. The result will necessarily be an integer.
+% \end{function}
+%
% \begin{function}[added = 2014-07-15, EXP]
% {\dim_to_decimal_in_unit:nn}
% \begin{syntax}
@@ -490,6 +499,13 @@
% \end{verbatim}
% leaves |0.35277| in the input stream, \emph{i.e.}~the magnitude of
% one big point when converted to millimetres.
+%
+% Note that this function is not optimised for any particular output
+% and as such may give different results to \cs{dim_to_decimal_in_bp:n}
+% or \cs{dim_to_decimal_in_sp:n}. In particular, the latter is able to
+% take a wider range of input values as it is not limited by the ability
+% to calculate a ratio using \eTeX{} primitives, which is required
+% internally by \cs{dim_to_decimal_in_unit:nn}.
% \end{function}
%
% \begin{function}[EXP, added = 2012-05-08, tested = m3fp-convert002]
@@ -1435,6 +1451,15 @@
{ \dim_to_decimal:n { ( #1 ) * 800 / 803 } }
% \end{macrocode}
% \end{macro}
+%
+% \begin{macro}[EXP]{\dim_to_decimal_in_sp:n}
+% Another hard-coded conversion: this one is necessary to avoid things going
+% off-scale.
+% \begin{macrocode}
+\cs_new:Npn \dim_to_decimal_in_sp:n #1
+ { \int_eval:n { \@@_eval:w #1 \@@_eval_end: } }
+% \end{macrocode}
+% \end{macro}
%
% \begin{macro}[EXP]{\dim_to_decimal_in_unit:nn}
% An analogue of \cs{dim_ratio:nn} that produces a decimal number as its