[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.