# HG changeset patch
# User Franz Glasner <fzglas.hg@dom66.de>
# Date 1726759919 -7200
# Node ID dbd793238b940b3975309b5255347b446390090b
# Parent  a84ba696ffd844951fd0362dcc9bd6a091a78090
farray.sh: Document that an alist preserves insertion order

diff -r a84ba696ffd8 -r dbd793238b94 share/local-bsdtools/farray.sh
--- 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:
 #: