[latex3-commits] [latex3/latex3] main: Doc improvements (fixes #961) (24c4b90b9)

[github at latex-project.org]

Repository : https://github.com/latex3/latex3
On branch  : main
Link       : https://github.com/latex3/latex3/commit/24c4b90b932f2411ee7df0588b020ee97edacf6b

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

commit 24c4b90b932f2411ee7df0588b020ee97edacf6b
Author: Joseph Wright <joseph.wright at morningstar2.co.uk>
Date:   Wed May 24 19:45:08 2023 +0100

    Doc improvements (fixes #961)


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

24c4b90b932f2411ee7df0588b020ee97edacf6b
 l3kernel/l3expan.dtx | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/l3kernel/l3expan.dtx b/l3kernel/l3expan.dtx
index 5dee1770a..961cb3bf6 100644
--- a/l3kernel/l3expan.dtx
+++ b/l3kernel/l3expan.dtx
@@ -134,7 +134,8 @@
 %   comma-separated list of \meta{variant argument specifiers} is
 %   then used to define variants of the
 %   \meta{original argument specifier} if these are not already
-%   defined. For each \meta{variant} given, a function is created
+%   defined; entries which correspond to existing functions are silently
+%   ingored. For each \meta{variant} given, a function is created
 %   that expands its arguments as detailed and passes them
 %   to the \meta{parent control sequence}. So for example
 %   \begin{verbatim}
@@ -158,7 +159,9 @@
 %   \cs[no-index]{exp_args:N\meta{variant}} function needed to carry out the
 %   expansion. There is no need to re-apply \cs{cs_generate_variant:Nn} after
 %   changing the definition of the parent function: the variant will always
-%   use the current definition of the parent.
+%   use the current definition of the parent. Providing variants repeatedly is
+%   safe as \cs{cs_generate_variant:Nn} will only create new definitions if
+%   there is not already one available.
 %
 %   Only |n|~and |N| arguments can be changed to other types.  The only
 %   allowed changes are