Commit: runtime(doc): Update the tuple help text

[Christian Brabandt]

runtime(doc): Update the tuple help text

Commit: https://github.com/vim/vim/commit/1c2f475850d94da26d77dc3cd8c85620edda3dce
Author: Yegappan Lakshmanan <yega...@yahoo.com>
Date: Sun Mar 30 15:37:24 2025 +0200

runtime(doc): Update the tuple help text

closes: https://github.com/vim/vim/issues/17009

Co-authored-by: Hirohito Higashi <h.eas...@gmail.com>
Signed-off-by: Yegappan Lakshmanan <yega...@yahoo.com>
Signed-off-by: Christian Brabandt <c...@256bit.org>

diff --git a/runtime/doc/builtin.txt b/runtime/doc/builtin.txt
index b903b3887..5a72e214f 100644
--- a/runtime/doc/builtin.txt
+++ b/runtime/doc/builtin.txt
@@ -1,4 +1,4 @@
-*builtin.txt* For Vim version 9.1. Last change: 2025 Mar 26
+*builtin.txt* For Vim version 9.1. Last change: 2025 Mar 30


VIM REFERENCE MANUAL by Bram Moolenaar
@@ -11923,7 +11923,7 @@ trunc({expr}) *trunc()*
Return type: |Float|


-tuple2list({list}) *tuple2list()*
+tuple2list({tuple}) *tuple2list()*
Create a List from a shallow copy of the tuple items.
Examples: >
tuple2list((1, 2, 3)) returns [1, 2, 3]
diff --git a/runtime/doc/eval.txt b/runtime/doc/eval.txt
index bcd64e30a..7ea768aef 100644
--- a/runtime/doc/eval.txt
+++ b/runtime/doc/eval.txt
@@ -1,4 +1,4 @@
-*eval.txt* For Vim version 9.1. Last change: 2025 Mar 23
+*eval.txt* For Vim version 9.1. Last change: 2025 Mar 30


VIM REFERENCE MANUAL by Bram Moolenaar
@@ -541,7 +541,8 @@ example, to add up all the numbers in a list: >
A Tuple is an ordered sequence of items. An item can be of any type. Items
can be accessed by their index number. A Tuple is immutable.

-A Tuple uses less memory compared to a List and provides O(1) lookup time.
+A Tuple is similar to a List but uses less memory and provides O(1) lookup
+time for an item.

Tuple creation ~
*E1526* *E1527*
@@ -579,6 +580,15 @@ is not available it returns zero or the default value you specify: >
:echo get(mytuple, idx, "NONE")


+Tuple modification ~
+ *tuple-modification*
+A tuple is immutable and items cannot be added or removed from a tuple. But
+List and Dict items within a tuple can be modified: >
+ :let tuple = (1, [2, 3], {'a': 4})
+ :let tuple[1][0] = 10
+ :let tuple[2]['a'] = 20
+
+
Tuple concatenation ~
*tuple-concatenation*
Two tuples can be concatenated with the "+" operator: >
diff --git a/runtime/doc/tags b/runtime/doc/tags
index 7d54ee9b8..fa4709224 100644
--- a/runtime/doc/tags
+++ b/runtime/doc/tags
@@ -10937,6 +10937,7 @@ tuple-concatenation eval.txt /*tuple-concatenation*
tuple-functions usr_41.txt /*tuple-functions*
tuple-identity eval.txt /*tuple-identity*
tuple-index eval.txt /*tuple-index*
+tuple-modification eval.txt /*tuple-modification*
tuple-type vim9.txt /*tuple-type*
tuple2list() builtin.txt /*tuple2list()*
tutor usr_01.txt /*tutor*
diff --git a/runtime/doc/usr_41.txt b/runtime/doc/usr_41.txt
index 4c5e5ef4c..8279e3e99 100644
--- a/runtime/doc/usr_41.txt
+++ b/runtime/doc/usr_41.txt
@@ -1,4 +1,4 @@
-*usr_41.txt* For Vim version 9.1. Last change: 2025 Mar 23
+*usr_41.txt* For Vim version 9.1. Last change: 2025 Mar 30

VIM USER MANUAL - by Bram Moolenaar

@@ -862,7 +862,7 @@ Tuple manipulation: *tuple-functions*
reverse() reverse the order of items in a Tuple
slice() take a slice of a Tuple
string() string representation of a Tuple
- tuple2list() convert a Tuple of items into a list
+ tuple2list() convert a Tuple into a List

Dictionary manipulation: *dict-functions*
get() get an entry without an error for a wrong key