feat(lua): add vim.iter (#23029)

vim.iter wraps a table or iterator function into an `Iter` object with
methods such as `filter`, `map`, and `fold` which can be chained to
produce iterator pipelines that do not create new tables at each step.

1 files changed, 4 insertions, 0 deletions

diff --git a/scripts/gen_vimdoc.py b/scripts/gen_vimdoc.py
index 8860bdd5c6..52d03d9746 100755
--- a/scripts/gen_vimdoc.py
+++ b/scripts/gen_vimdoc.py
@@ -154,8 +154,10 @@ CONFIG = {
             'fs.lua',
             'secure.lua',
             'version.lua',
+            'iter.lua',
         ],
         'files': [
+            'runtime/lua/vim/iter.lua',
             'runtime/lua/vim/_editor.lua',
             'runtime/lua/vim/shared.lua',
             'runtime/lua/vim/loader.lua',
@@ -185,6 +187,8 @@ CONFIG = {
         'fn_helptag_fmt': lambda fstem, name: (
             f'*vim.{name}()*'
             if fstem.lower() == '_editor'
+            else f'*{name}()*'
+            if fstem in ('iter.lua')
             else f'*{fstem}.{name}()*'),
         'module_override': {
             # `shared` functions are exposed on the `vim` module.