diff options
Diffstat (limited to 'Master/texmf-dist/source/latex/l3kernel/l3keys.dtx')
-rw-r--r-- | Master/texmf-dist/source/latex/l3kernel/l3keys.dtx | 31 |
1 files changed, 16 insertions, 15 deletions
diff --git a/Master/texmf-dist/source/latex/l3kernel/l3keys.dtx b/Master/texmf-dist/source/latex/l3kernel/l3keys.dtx index 5228a9c19ea..6c90e67d52d 100644 --- a/Master/texmf-dist/source/latex/l3kernel/l3keys.dtx +++ b/Master/texmf-dist/source/latex/l3kernel/l3keys.dtx @@ -43,7 +43,7 @@ % }^^A % } % -% \date{Released 2024-12-09} +% \date{Released 2024-12-25} % % \maketitle % @@ -184,12 +184,13 @@ % \begin{function}[updated = 2013-07-08] % {.bool_set:N, .bool_set:c, .bool_gset:N, .bool_gset:c} % \begin{syntax} -% \meta{key} .bool_set:N = \meta{boolean variable} +% \meta{key} .bool_set:N = \meta{boolean} % \end{syntax} -% Defines \meta{key} to set \meta{boolean variable} to \meta{value} (which -% must be either \enquote{\texttt{true}} or \enquote{\texttt{false}}). If the variable -% does not exist, it will be created globally at the point that -% the key is set up. +% Defines \meta{key} to set \meta{boolean} to \meta{value}. If the +% \meta{value} is given, it must be one either \enquote{\texttt{true}} or +% \enquote{\texttt{false}}); it may be omitted, which is equivalent to +% \texttt{true}. If the variable does not exist, it will be created globally +% at the point that the key is set up. % \end{function} % % \begin{function}[added = 2011-08-28, updated = 2013-07-08] @@ -198,12 +199,12 @@ % .bool_gset_inverse:N, .bool_gset_inverse:c % } % \begin{syntax} -% \meta{key} .bool_set_inverse:N = \meta{boolean variable} +% \meta{key} .bool_set_inverse:N = \meta{boolean} % \end{syntax} -% Defines \meta{key} to set \meta{boolean variable} to the logical +% Defines \meta{key} to set \meta{boolean} to the logical % inverse of \meta{value} (which must be either \enquote{\texttt{true}} or % \enquote{\texttt{false}}). -% If the \meta{boolean variable} does not exist, it will be created globally +% If the \meta{boolean} does not exist, it will be created globally % at the point that the key is set up. % \end{function} % @@ -310,9 +311,9 @@ % \begin{function}[updated = 2020-01-17] % {.fp_set:N, .fp_set:c, .fp_gset:N, .fp_gset:c} % \begin{syntax} -% \meta{key} .fp_set:N = \meta{floating point} +% \meta{key} .fp_set:N = \meta{fp var} % \end{syntax} -% Defines \meta{key} to set \meta{floating point} to \meta{value} +% Defines \meta{key} to set \meta{fp var} to \meta{value} % (which must a floating point expression). If the variable does not exist, % it is created globally at the point that the key is set up. The key will % require a value at point-of-use unless a default is set. @@ -367,7 +368,7 @@ % \meta{key} .initial:n = \Arg{value} % \end{syntax} % Initialises the \meta{key} with the \meta{value}, equivalent to -% \begin{quote} +% \begin{quote}\ttfamily % \cs{keys_set:nn} \Arg{module} \{ \meta{key} = \meta{value} \} % \end{quote} % \end{function} @@ -934,9 +935,9 @@ % % It is important to note that when precompiling keys, no expansion of variables % takes place. This means that any key setting which simply stores variable names, -% rather than variable values, will not work correctly. Most notably, any -% key setting which uses \cs{l_keys_key_str}, \cs{l_keys_path_str} or -% \cs{l_keys_value_tl} will yield unpredictable outcomes. As such, keys +% rather than variable values, may not work correctly. Most notably, any +% key setting which uses key status variables (\cs{l_keys_key_str}, etc.) +% will yield unpredictable outcomes. As such, keys % intended to be precompiled should fully expand any values at the point of % setting. % \end{function} |