[latex3-commits] [latex3/latex3] main: Extend documentation of .default:n (closes #989) (51e414b13)

github at latex-project.org github at latex-project.org
Wed May 24 09:46:36 CEST 2023


Repository : https://github.com/latex3/latex3
On branch  : main
Link       : https://github.com/latex3/latex3/commit/51e414b13d0e2285212f5935797b4eb6dd2d5037

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

commit 51e414b13d0e2285212f5935797b4eb6dd2d5037
Author: Joseph Wright <joseph.wright at morningstar2.co.uk>
Date:   Wed May 24 08:46:36 2023 +0100

    Extend documentation of .default:n (closes #989)


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

51e414b13d0e2285212f5935797b4eb6dd2d5037
 l3kernel/l3keys.dtx | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/l3kernel/l3keys.dtx b/l3kernel/l3keys.dtx
index e3093de85..09ac5d7cc 100644
--- a/l3kernel/l3keys.dtx
+++ b/l3kernel/l3keys.dtx
@@ -286,6 +286,12 @@
 %   forbidden. Thus a required value cannot be supplied by a default
 %   value, and giving a default value for a key which cannot take a value
 %   does not trigger an error.
+%
+%   When no value is given for a key as part of \cs{keys_set:nn}, the
+%   \texttt{.default:n} value provides the value before key properties are
+%   consider. The only exception is when the \texttt{.value_required:n}
+%   property is active: a required value cannot be supplied by the default,
+%   and must be explicitly given as part of \cs{keys_set:nn}.
 % \end{function}
 %
 % \begin{function}[updated = 2020-01-17]





More information about the latex3-commits mailing list.