diff options
author | Norbert Preining <norbert@preining.info> | 2022-02-22 03:00:54 +0000 |
---|---|---|
committer | Norbert Preining <norbert@preining.info> | 2022-02-22 03:00:54 +0000 |
commit | fb013a78d9e3aef2ecf58702d4adcec8d9ab6b28 (patch) | |
tree | d4402a058adb8131b94ec026d7be01cca51d8862 /macros/latex/contrib/l3kernel/l3keys.dtx | |
parent | a9409c96664c73e4fd0586f358845df19b1afd62 (diff) |
CTAN sync 202202220300
Diffstat (limited to 'macros/latex/contrib/l3kernel/l3keys.dtx')
-rw-r--r-- | macros/latex/contrib/l3kernel/l3keys.dtx | 15 |
1 files changed, 13 insertions, 2 deletions
diff --git a/macros/latex/contrib/l3kernel/l3keys.dtx b/macros/latex/contrib/l3kernel/l3keys.dtx index 087bbf411d..6c8d1ff55f 100644 --- a/macros/latex/contrib/l3kernel/l3keys.dtx +++ b/macros/latex/contrib/l3kernel/l3keys.dtx @@ -43,7 +43,7 @@ % }^^A % } % -% \date{Released 2022-02-05} +% \date{Released 2022-02-21} % % \maketitle % @@ -87,6 +87,10 @@ % key-two = value two % } % \end{verbatim} +% As illustrated, keys are created inside a \meta{module}: a set of related +% keys, typically those for a single module/\LaTeXe{} package. See +% Section~\label{sec:l3keys:subdivision} for suggestions on how to divide +% large numbers of keys for a single module. % % At a document level, \cs{keys_set:nn} is used within a % document function, for example @@ -321,7 +325,8 @@ % \meta{key} .inherit:n = \Arg{parents} % \end{syntax} % Specifies that the \meta{key} path should inherit the keys listed -% as \meta{parents}. For example, after setting +% as any of the \meta{parents} (a comma list), which can be a module +% or a subgroup. For example, after setting % \begin{verbatim} % \keys_define:nn { foo } { test .code:n = \tl_show:n {#1} } % \keys_define:nn { } { bar .inherit:n = foo } @@ -334,6 +339,12 @@ % \begin{verbatim} % \keys_set:nn { foo } { test = a } % \end{verbatim} +% Inheritance applies at point of use, not at definition, thus keys may +% be added to the \meta{parent} after the use of \texttt{.inherit:n} +% and will be active. +% If more than one \meta{parent} is specified, the presence of the +% \meta{key} will be tested for each in turn, with the first successful +% hit taking priority. % \end{function} % % \begin{function}[updated = 2013-07-09] |