runtime(doc): Update the tuple help text
closes: #17009
Co-authored-by: Hirohito Higashi <h.east.727@gmail.com>
Signed-off-by: Yegappan Lakshmanan <yegappan@yahoo.com>
Signed-off-by: Christian Brabandt <cb@256bit.org>
diff --git a/runtime/doc/builtin.txt b/runtime/doc/builtin.txt
index b903b38..5a72e21 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 @@
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 bcd64e3..7ea768a 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 @@
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 @@
: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 7d54ee9..fa47092 100644
--- a/runtime/doc/tags
+++ b/runtime/doc/tags
@@ -10937,6 +10937,7 @@
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 4c5e5ef..8279e3e 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 @@
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