[latex3-commits] [latex3/latex3] main: Document max. dim conversion values (see #1217) (7e7131f1c)

[github at latex-project.org]

Repository : https://github.com/latex3/latex3
On branch  : main
Link       : https://github.com/latex3/latex3/commit/7e7131f1c7fd488d5222ef18782b3fe7bda859ef

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

commit 7e7131f1c7fd488d5222ef18782b3fe7bda859ef
Author: Joseph Wright <joseph.wright at morningstar2.co.uk>
Date:   Mon May 22 09:33:07 2023 +0100

    Document max. dim conversion values  (see #1217)


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

7e7131f1c7fd488d5222ef18782b3fe7bda859ef
 l3kernel/l3skip.dtx | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/l3kernel/l3skip.dtx b/l3kernel/l3skip.dtx
index 4033994ea..46fc00d0e 100644
--- a/l3kernel/l3skip.dtx
+++ b/l3kernel/l3skip.dtx
@@ -548,6 +548,25 @@
 %   \emph{no units}. If the decimal part of the result is zero, it is omitted,
 %   together with the decimal marker. The precisions of the result is limited
 %   to a maximum of five decimal places with trailing zeros omitted.
+%
+%   The maximum \TeX{} allowable dimension value (available as
+%   \tn{maxdimen} in plain \TeX{} and \LaTeX{} and \cs{c_max_dim} in
+%   \pkg{expl3}) can only be expressed in the units \texttt{pt}, \texttt{bp}
+%   and \texttt{sp}. An input value equal to \cs{c_max_dim} in any other units
+%   will result in an overflow, as it will convert to an internal value
+%   (in \texttt{sp}) which is too large. As such, the maximum input values in
+%   different units are\\
+%   \begin{center}
+%     \begin{tabular}{@{}>{$}r<{$}@{\,}l@{}}
+%      1276.00215 & cc \\
+%       575.83174 & cm \\
+%       226.70540 & in \\
+%     15312.02584 & dd \\
+%      5758.31742 & mm \\
+%      1279.62627 & nc \\
+%      1365.33333 & pc \\
+%     \end{tabular}
+%   \end{center}
 %   \begin{texnote}
 %      The implementation of this functions is re-entrant: the result of
 %      \begin{verbatim}