changeset 611:dbd793238b94

farray.sh: Document that an alist preserves insertion order
author Franz Glasner <fzglas.hg@dom66.de>
date Thu, 19 Sep 2024 17:31:59 +0200
parents a84ba696ffd8
children c9ef2339618d
files share/local-bsdtools/farray.sh
diffstat 1 files changed, 2 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/share/local-bsdtools/farray.sh	Thu Sep 19 17:19:35 2024 +0200
+++ b/share/local-bsdtools/farray.sh	Thu Sep 19 17:31:59 2024 +0200
@@ -62,6 +62,8 @@
 #: - The same is true if ``_farr_K_<TOKEN>_<INDEX>`` or
 #:   ``_farr_V_<TOKEN>_<INDEX>`` is unexpectedly unset.
 #:   Exceptions to this rule are documented.
+#: - An alist preserves insertion order. Note that updating a key does not
+#:   affect the order. Keys added after deletion are inserted at the end.
 #:
 #: Hints and rules for indexes:
 #: