[latex3-commits] [latex3/latex3] gh1040-prop-large: Documentation improvements in l3prop (be5e05f31)

[github at latex-project.org]

Repository : https://github.com/latex3/latex3
On branch  : gh1040-prop-large
Link       : https://github.com/latex3/latex3/commit/be5e05f31ad5792c70b13c169dc11732a64ea0c1

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

commit be5e05f31ad5792c70b13c169dc11732a64ea0c1
Author: Bruno Le Floch <blflatex at gmail.com>
Date:   Mon Feb 12 13:22:13 2024 +0100

    Documentation improvements in l3prop


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

be5e05f31ad5792c70b13c169dc11732a64ea0c1
 l3kernel/l3prop.dtx | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/l3kernel/l3prop.dtx b/l3kernel/l3prop.dtx
index 0f8487ef1..2a6798621 100644
--- a/l3kernel/l3prop.dtx
+++ b/l3kernel/l3prop.dtx
@@ -64,7 +64,9 @@
 %
 % Property lists are intended for storing key-based information for use within
 % code. They can be converted from and to key--value lists, which are a form of
-% \emph{input} parsed by the \pkg{l3keys} module.
+% \emph{input} parsed by the \pkg{l3keys} module.  If a key--value list contains
+% a \meta{key} multiple times, only the last \meta{value} associated to it will
+% be kept in the conversion to a property list.
 %
 % Internally, property lists can use two distinct implementations with different
 % data storage, which are decided when declaring the property list variable
@@ -137,6 +139,10 @@
 %   Ensures that the \meta{property list} exists globally by applying
 %   \cs{prop_new:N} if necessary, then applies
 %   \cs[index=prop_clear:N]{prop_(g)clear:N} to leave the list empty.
+%   \begin{texnote}
+%     If the property list exists and is of \enquote{linked} type, it
+%     is cleared but not made into a flat property list.
+%   \end{texnote}
 % \end{function}
 %
 % \begin{function}[added = 2024-01-15]
@@ -150,6 +156,10 @@
 %   Ensures that the \meta{property list} exists globally by applying
 %   \cs{prop_new_linked:N} if necessary, then applies
 %   \cs[index=prop_clear:N]{prop_(g)clear:N} to leave the list empty.
+%   \begin{texnote}
+%     If the property list exists and is of \enquote{flat} type, it
+%     is cleared but not made into a linked property list.
+%   \end{texnote}
 % \end{function}
 %
 % \begin{function}