runtime(doc): update return types for builtin functions

fixes: #17273

credit: Github user @msoyka2024
Signed-off-by: Christian Brabandt <cb@256bit.org>

diff --git a/runtime/doc/builtin.txt b/runtime/doc/builtin.txt
index 55a0731a81e181fb4eeef393bc58d90c6809dad7..3f52e109cc70b48f97bc409ac84444b0d0a48f51 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 Apr 27
+*builtin.txt*  For Vim version 9.1.  Last change: 2025 May 08
 
 
                  VIM REFERENCE MANUAL    by Bram Moolenaar
@@ -194,9 +194,8 @@ filter({expr1}, {expr2})    List/Dict/Blob/String
                                        remove items from {expr1} where
                                        {expr2} is 0
 finddir({name} [, {path} [, {count}]])
-                               String  find directory {name} in {path}
 findfile({name} [, {path} [, {count}]])
-                               String  find file {name} in {path}
+                               String/List find dir/file {name} in {path}
 flatten({list} [, {maxdepth}]) List    flatten {list} up to {maxdepth} levels
 flattennew({list} [, {maxdepth}])
                                List    flatten a copy of {list}
@@ -2286,6 +2285,7 @@ cursor({list})
                Can also be used as a |method|: >
                        GetCursorPos()->cursor()
 <
+               Returns 0 when the position could be set, -1 otherwise.
                Return type: |Number|
 
 
@@ -3167,7 +3167,7 @@ feedkeys({string} [, {mode}])                             *feedkeys()*
                Can also be used as a |method|: >
                        GetInput()->feedkeys()
 <
-               Return type: |String| or list<string> depending on {list}
+               Return type: |Number|
 
 
 filecopy({from}, {to})                                 *filecopy()*
@@ -4962,7 +4962,7 @@ getreg([{regname} [, 1 [, {list}]]])                      *getreg()*
                Can also be used as a |method|: >
                        GetRegname()->getreg()
 <
-               Return type: |String|
+               Return type: |String| or list<string> depending on {list}
 
 
 getreginfo([{regname}])                                        *getreginfo()*
@@ -9828,6 +9828,7 @@ setcursorcharpos({list})
                Can also be used as a |method|: >
                        GetCursorPos()->setcursorcharpos()
 <
+               Returns 0 when the position could be set, -1 otherwise.
                Return type: |Number|