[latex3-commits] [git/LaTeX3-latex3-latex3] main: Standardise 'property list' (fixes #1032) (51e32f3e2)
Joseph Wright
joseph.wright at morningstar2.co.uk
Wed Nov 9 07:08:33 CET 2022
Repository : https://github.com/latex3/latex3
On branch : main
Link : https://github.com/latex3/latex3/commit/51e32f3e24f7c60f12808c5e50b3e3fabf3e20d1
>---------------------------------------------------------------
commit 51e32f3e24f7c60f12808c5e50b3e3fabf3e20d1
Author: Joseph Wright <joseph.wright at morningstar2.co.uk>
Date: Wed Nov 9 06:08:33 2022 +0000
Standardise 'property list' (fixes #1032)
>---------------------------------------------------------------
51e32f3e24f7c60f12808c5e50b3e3fabf3e20d1
l3kernel/l3candidates.dtx | 2 +-
l3kernel/l3prop.dtx | 32 ++++++++++++++++----------------
2 files changed, 17 insertions(+), 17 deletions(-)
diff --git a/l3kernel/l3candidates.dtx b/l3kernel/l3candidates.dtx
index c0e69c752..2c558ba17 100644
--- a/l3kernel/l3candidates.dtx
+++ b/l3kernel/l3candidates.dtx
@@ -347,7 +347,7 @@
% \begin{function}[EXP, added = 2016-12-06]
% {\prop_rand_key_value:N, \prop_rand_key_value:c}
% \begin{syntax}
-% \cs{prop_rand_key_value:N} \meta{prop~var}
+% \cs{prop_rand_key_value:N} \meta{property list}
% \end{syntax}
% Selects a pseudo-random key--value pair from the \meta{property list}
% and returns \Arg{key} and \Arg{value}. If the \meta{property list} is
diff --git a/l3kernel/l3prop.dtx b/l3kernel/l3prop.dtx
index c12445936..e7975ca29 100644
--- a/l3kernel/l3prop.dtx
+++ b/l3kernel/l3prop.dtx
@@ -49,7 +49,7 @@
%
% \begin{documentation}
%
-% \LaTeX3 implements a \enquote{property list} data type, which contain
+% \LaTeX3 implements a \meta{property list} data type, which contain
% an unordered list of entries each of which consists of a \meta{key} and
% an associated \meta{value}. The \meta{key} and \meta{value} may both
% be any \meta{balanced text}, the \meta{key} is processed using
@@ -117,13 +117,13 @@
% \prop_gset_from_keyval:Nn, \prop_gset_from_keyval:cn,
% }
% \begin{syntax}
-% \cs{prop_set_from_keyval:Nn} \meta{prop~var}
+% \cs{prop_set_from_keyval:Nn} \meta{property list}
% \{
% \meta{key1} |=| \meta{value1} |,|
% \meta{key2} |=| \meta{value2} |,| \ldots{}
% \}
% \end{syntax}
-% Sets \meta{prop~var} to contain key--value pairs given in the second
+% Sets \meta{property list} to contain key--value pairs given in the second
% argument. If duplicate keys appear only the last of the values is kept.
%
% Spaces are trimmed around every \meta{key} and every \meta{value},
@@ -142,14 +142,14 @@
% \begin{function}[added = 2017-11-28, updated = 2021-11-07]
% {\prop_const_from_keyval:Nn, \prop_const_from_keyval:cn}
% \begin{syntax}
-% \cs{prop_const_from_keyval:Nn} \meta{prop~var}
+% \cs{prop_const_from_keyval:Nn} \meta{property list}
% \{
% \meta{key1} |=| \meta{value1} |,|
% \meta{key2} |=| \meta{value2} |,| \ldots{}
% \}
% \end{syntax}
-% Creates a new constant \meta{prop~var} or raises an error if the
-% name is already taken. The \meta{prop~var} is set globally to
+% Creates a new constant \meta{property list} or raises an error if the
+% name is already taken. The \meta{property list} is set globally to
% contain key--value pairs given in the second argument, processed in
% the way described for \cs{prop_set_from_keyval:Nn}. If duplicate
% keys appear only the last of the values is kept.
@@ -209,12 +209,12 @@
% \prop_gconcat:NNN, \prop_gconcat:ccc
% }
% \begin{syntax}
-% \cs{prop_concat:NNN} \meta{prop~var_1} \meta{prop~var_2} \meta{prop~var_3}
+% \cs{prop_concat:NNN} \meta{property list_1} \meta{property list_2} \meta{property list3}
% \end{syntax}
-% Combines the key--value pairs of \meta{prop~var_2} and
-% \meta{prop~var_3}, and saves the result in \meta{prop~var_1}. If a
-% key appears in both \meta{prop~var_2} and \meta{prop~var_3} then the
-% last value, namely the value in \meta{prop~var_3} is kept.
+% Combines the key--value pairs of \meta{property list_2} and
+% \meta{property list_3}, and saves the result in \meta{pproperty list_1}. If a
+% key appears in both \meta{property list_2} and \meta{property list_3} then the
+% last value, namely the value in \meta{property list_3} is kept.
% \end{function}
%
% \begin{function}[added = 2021-05-16, updated = 2021-11-07]
@@ -223,22 +223,22 @@
% \prop_gput_from_keyval:Nn, \prop_gput_from_keyval:cn,
% }
% \begin{syntax}
-% \cs{prop_put_from_keyval:Nn} \meta{prop~var}
+% \cs{prop_put_from_keyval:Nn} \meta{property list}
% \{
% \meta{key1} |=| \meta{value1} |,|
% \meta{key2} |=| \meta{value2} |,| \ldots{}
% \}
% \end{syntax}
-% Updates the \meta{prop~var} by adding entries for each key--value
+% Updates the \meta{property list} by adding entries for each key--value
% pair given in the second argument. The addition is done through
-% \cs{prop_put:Nnn}, hence if the \meta{prop~var} already contains
+% \cs{prop_put:Nnn}, hence if the \meta{property list} already contains
% some of the keys, the corresponding values are discarded and
% replaced by those given in the key--value list. If duplicate keys
% appear in the key--value list then only the last of the values is kept.
%
% The function is equivalent to storing the key--value pairs in a
-% temporary property variable using \cs{prop_set_from_keyval:Nn}, then
-% combining \meta{prop~var} with the temporary variable using
+% temporary property list using \cs{prop_set_from_keyval:Nn}, then
+% combining \meta{property list} with the temporary variable using
% \cs{prop_concat:NNN}. In particular, the \meta{keys} and
% \meta{values} are space-trimmed and unbraced as described in
% \cs{prop_set_from_keyval:Nn}.
More information about the latex3-commits
mailing list.