[latex3-commits] [git/LaTeX3-latex3-latex3] main: warn about unordered property lists (f3d62ffd4)

[Joseph Wright]

Repository : https://github.com/latex3/latex3
On branch  : main
Link       : https://github.com/latex3/latex3/commit/f3d62ffd4ef849d2215747a0c00ad2b275563669

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

commit f3d62ffd4ef849d2215747a0c00ad2b275563669
Author: Jonathan Spratte <jspratte at yahoo.de>
Date:   Mon Nov 16 22:00:26 2020 +0100

    warn about unordered property lists


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

f3d62ffd4ef849d2215747a0c00ad2b275563669
 l3kernel/l3prop.dtx | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/l3kernel/l3prop.dtx b/l3kernel/l3prop.dtx
index cffe16ab2..f25f738d8 100644
--- a/l3kernel/l3prop.dtx
+++ b/l3kernel/l3prop.dtx
@@ -315,7 +315,9 @@
 %   \begin{syntax}
 %     \cs{prop_to_keyval:N} \meta{property list}
 %   \end{syntax}
-%   Expands to the \meta{property list} in a key--value notation.
+%   Expands to the \meta{property list} in a key--value notation. Keep in mind
+%   that a \meta{property list} is \emph{unordered}, while key--value interfaces
+%   don't necessarily are, so this can't be used for arbitrary interfaces.
 %   \begin{texnote}
 %     The result is returned within the \tn{unexpanded} primitive
 %     (\cs{exp_not:n}), which means that the key--value list does not expand