docs: misc

Co-authored-by: Au. <acehinnnqru@gmail.com>
Co-authored-by: Daniel Rainer <daniel.rainer@localhost>
Co-authored-by: Evgeni Chasnovski <evgeni.chasnovski@gmail.com>
Co-authored-by: Lewis Russell <lewis6991@gmail.com>
Co-authored-by: Luuk van Baal <luukvbaal@gmail.com>
Co-authored-by: Pierre Barbin <pierre@heitzsystem.com>
Co-authored-by: Riley Bruins <ribru17@hotmail.com>
Co-authored-by: Yinzuo Jiang <jiangyinzuo@foxmail.com>
Co-authored-by: phanium <91544758+phanen@users.noreply.github.com>
Co-authored-by: zeertzjq <zeertzjq@outlook.com>

runtime/lua/vim/_meta/api.lua

@@ -630,8 +630,7 @@ function vim.api.nvim_buf_line_count(buffer) end
 ---      otherwise the same as "trunc".
 --- - ephemeral : for use with `nvim_set_decoration_provider()`
 ---     callbacks. The mark will only be used for the current
----     redraw cycle, and not be permantently stored in the
----     buffer.
+---     redraw cycle, and not be permanently stored in the buffer.
 --- - right_gravity : boolean that indicates the direction
 ---     the extmark will be shifted in when new text is inserted
 ---     (true for right, false for left). Defaults to true.

runtime/lua/vim/_meta/builtin_types.lua

@@ -259,12 +259,12 @@
 --- write.  The number is the write count.  The
 --- first write has number 1, the last one the
 --- "save_last" mentioned above.
---- @field save integer
+--- @field save? integer
 ---
 --- Alternate entry.  This is again a List of undo
 --- blocks.  Each item may again have an "alt"
 --- item.
---- @field alt vim.fn.undotree.entry[]
+--- @field alt? vim.fn.undotree.entry[]
 
 --- @class vim.fn.undotree.ret
 ---

runtime/lua/vim/_meta/vimfn.lua

@@ -5868,7 +5868,7 @@ function vim.fn.matchend(expr, pat, start, count) end
 ---
 --- @param list any[]
 --- @param str string
---- @param dict? string
+--- @param dict? table
 --- @return any
 function vim.fn.matchfuzzy(list, str, dict) end
 
@@ -5895,7 +5895,7 @@ function vim.fn.matchfuzzy(list, str, dict) end
 ---
 --- @param list any[]
 --- @param str string
---- @param dict? string
+--- @param dict? table
 --- @return any
 function vim.fn.matchfuzzypos(list, str, dict) end
 

runtime/lua/vim/iter.lua

@@ -652,7 +652,7 @@ end
 ---
 --- ```
 ---
----@see Iter.find
+---@see |Iter:find()|
 ---
 ---@param f any
 ---@return any
@@ -757,7 +757,7 @@ end
 --- -- 4
 --- ```
 ---
----@see Iter.last
+---@see |Iter:last()|
 ---
 ---@return any
 function Iter:rpeek()
@@ -942,7 +942,7 @@ end
 ---
 --- ```
 ---
----@see Iter.rpeek
+---@see |Iter:rpeek()|
 ---
 ---@return any
 function Iter:last()

runtime/lua/vim/shared.lua

@@ -7,7 +7,8 @@
 -- so this wouldn't be a separate case to consider)
 
 ---@nodoc
-_G.vim = _G.vim or {} --[[@as table]] -- TODO(lewis6991): better fix for flaky luals
+_G.vim = _G.vim or {} --[[@as table]]
+-- TODO(lewis6991): better fix for flaky luals
 
 ---@generic T
 ---@param orig T