[latex3-commits] [git/LaTeX3-latex3-latex3] master: Document what \int_to_roman:n does beyond 5000 [ci skip] (fixes #540) (16d63c9)

[Bruno Le Floch]

Repository : https://github.com/latex3/latex3
On branch  : master
Link       : https://github.com/latex3/latex3/commit/16d63c9a49371f291ac57939f280e7adbc8f3da5

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

commit 16d63c9a49371f291ac57939f280e7adbc8f3da5
Author: Bruno Le Floch <bruno at le-floch.fr>
Date:   Fri Feb 22 15:34:23 2019 +0100

    Document what \int_to_roman:n does beyond 5000 [ci skip] (fixes #540)


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

16d63c9a49371f291ac57939f280e7adbc8f3da5
 l3kernel/l3int.dtx |   10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/l3kernel/l3int.dtx b/l3kernel/l3int.dtx
index 947a91f..020e86e 100644
--- a/l3kernel/l3int.dtx
+++ b/l3kernel/l3int.dtx
@@ -698,9 +698,13 @@
 %     \cs{int_to_roman:n} \Arg{integer expression}
 %   \end{syntax}
 %   Places the value of the \meta{integer expression} in the input
-%   stream as Roman numerals, either lower case (\cs{int_to_roman:n})
-%   or upper case (\cs{int_to_Roman:n}). The Roman numerals are letters
-%   with category code $11$ (letter).
+%   stream as Roman numerals, either lower case (\cs{int_to_roman:n}) or
+%   upper case (\cs{int_to_Roman:n}).  If the value is negative or zero,
+%   the output is empty.  The Roman numerals are letters with category
+%   code $11$ (letter).  The letters used are |mdclxvi|, repeated as
+%   needed: the notation with bars (such as $\bar{\mbox{v}}$ for $5000$)
+%   is \emph{not} used.  For instance \cs{int_to_roman:n} |{| 8249 |}|
+%   expands to |mmmmmmmmccxlix|.
 % \end{function}
 %
 % \section{Converting from other formats to integers}