runtime(doc): correct another problem in :h items()

The returned value is only in arbitrary order for a Dict.

closes: #18050

Signed-off-by: zeertzjq <zeertzjq@outlook.com>
Signed-off-by: Christian Brabandt <cb@256bit.org>

diff --git a/runtime/doc/builtin.txt b/runtime/doc/builtin.txt
index 44818dd59f2cb9fa08a1660cadfb7e47b1816707..7cac6b9a570efb50a84d72e3d48640d776aa4965 100644 (file)
--- a/runtime/doc/builtin.txt
+++ b/runtime/doc/builtin.txt
@@ -1,4 +1,4 @@
-*builtin.txt*  For Vim version 9.1.  Last change: 2025 Aug 18
+*builtin.txt*  For Vim version 9.1.  Last change: 2025 Aug 20
 
 
                  VIM REFERENCE MANUAL    by Bram Moolenaar
@@ -6315,7 +6315,8 @@ items({expr})                                             *items()*
                Each |List| item is a list with two items:
                - for a |Dict|: the key and the value
                - for a |List|, |Tuple| or |String|: the index and the value
-               The |List| is in arbitrary order.
+               The returned |List| is in arbitrary order for a |Dict|,
+               otherwise it's in ascending order of the index.
 
                Also see |keys()| and |values()|.