docs(builtin): fix some missing lines (#24759)

Some things got chopped off in the PR that removed method syntax examples.
These were all that I found.

3 files changed, 24 insertions, 0 deletions

diff --git a/runtime/doc/builtin.txt b/runtime/doc/builtin.txt
index 8e92ca4e1c..94e9223ee9 100644
--- a/runtime/doc/builtin.txt
+++ b/runtime/doc/builtin.txt
@@ -429,6 +429,8 @@ bufname([{buf}])                                                     *bufname()*
 		with a listed buffer, that one is returned.  Next unlisted
 		buffers are searched for.
 		If the {buf} is a String, but you want to use it as a buffer
+		number, force it to be a Number by adding zero to it: >vim
+			echo bufname("3" + 0)
 <		If the buffer doesn't exist, or doesn't have a name, an empty
 		string is returned. >vim
 			echo bufname("#")	" alternate buffer name
@@ -3676,6 +3678,9 @@ interrupt()                                                        *interrupt()*
 
 invert({expr})                                                        *invert()*
 		Bitwise invert.  The argument is converted to a number.  A
+		List, Dict or Float argument causes an error.  Example: >vim
+			let bits = invert(bits)
+<
 
 isdirectory({directory})                                         *isdirectory()*
 		The result is a Number, which is |TRUE| when a directory
@@ -5665,6 +5670,9 @@ reverse({object})                                                    *reverse()*
 		{object} can be a |List| or a |Blob|.
 		Returns {object}.
 		Returns zero if {object} is not a List or a Blob.
+		If you want an object to remain unmodified make a copy first: >vim
+			let revlist = reverse(copy(mylist))
+<
 
 round({expr})                                                          *round()*
 		Round off {expr} to the nearest integral value and return it
diff --git a/runtime/lua/vim/_meta/vimfn.lua b/runtime/lua/vim/_meta/vimfn.lua
index d1c90249ed..ce325ce1f8 100644
--- a/runtime/lua/vim/_meta/vimfn.lua
+++ b/runtime/lua/vim/_meta/vimfn.lua
@@ -570,6 +570,8 @@ function vim.fn.bufloaded(buf) end
 --- with a listed buffer, that one is returned.  Next unlisted
 --- buffers are searched for.
 --- If the {buf} is a String, but you want to use it as a buffer
+--- number, force it to be a Number by adding zero to it: >vim
+---   echo bufname("3" + 0)
 --- <If the buffer doesn't exist, or doesn't have a name, an empty
 --- string is returned. >vim
 ---   echo bufname("#")  " alternate buffer name
@@ -4426,6 +4428,9 @@ function vim.fn.insert(object, item, idx) end
 function vim.fn.interrupt() end
 
 --- Bitwise invert.  The argument is converted to a number.  A
+--- List, Dict or Float argument causes an error.  Example: >vim
+---   let bits = invert(bits)
+--- <
 ---
 --- @param expr any
 --- @return any
@@ -6761,6 +6766,9 @@ function vim.fn.resolve(filename) end
 --- {object} can be a |List| or a |Blob|.
 --- Returns {object}.
 --- Returns zero if {object} is not a List or a Blob.
+--- If you want an object to remain unmodified make a copy first: >vim
+---   let revlist = reverse(copy(mylist))
+--- <
 ---
 --- @param object any
 --- @return any
diff --git a/src/nvim/eval.lua b/src/nvim/eval.lua
index 1ce6b0b247..e019e8fcab 100644
--- a/src/nvim/eval.lua
+++ b/src/nvim/eval.lua
@@ -796,6 +796,8 @@ M.funcs = {
       with a listed buffer, that one is returned.  Next unlisted
       buffers are searched for.
       If the {buf} is a String, but you want to use it as a buffer
+      number, force it to be a Number by adding zero to it: >vim
+      	echo bufname("3" + 0)
       <If the buffer doesn't exist, or doesn't have a name, an empty
       string is returned. >vim
       	echo bufname("#")	" alternate buffer name
@@ -5413,6 +5415,9 @@ M.funcs = {
     base = 1,
     desc = [=[
       Bitwise invert.  The argument is converted to a number.  A
+      List, Dict or Float argument causes an error.  Example: >vim
+      	let bits = invert(bits)
+      <
     ]=],
     name = 'invert',
     params = { { 'expr', 'any' } },
@@ -8150,6 +8155,9 @@ M.funcs = {
       {object} can be a |List| or a |Blob|.
       Returns {object}.
       Returns zero if {object} is not a List or a Blob.
+      If you want an object to remain unmodified make a copy first: >vim
+      	let revlist = reverse(copy(mylist))
+      <
     ]=],
     name = 'reverse',
     params = { { 'object', 'any' } },