neovim

commit 76dcc7029b200e1d85024d7ba4a34c602e730dbe
parent 203e7a43d1f209168a3cdae1650a9ef01db9cd72
Author: dundargoc <gocdundar@gmail.com>
Date:   Wed, 27 Nov 2024 15:36:38 +0100

docs: add tag `vim.fs.exists()` and document suggested replacement

Diffstat:
M
runtime/doc/lua.txt
 | 
11
+++++++++++
M
runtime/lua/vim/fs.lua
 | 
12
++++++++++++

2 files changed, 23 insertions(+), 0 deletions(-)
diff --git a/runtime/doc/lua.txt b/runtime/doc/lua.txt
@@ -2926,6 +2926,17 @@ vim.keymap.set({mode}, {lhs}, {rhs}, {opts})                *vim.keymap.set()*
 ==============================================================================
 Lua module: vim.fs                                                    *vim.fs*
 
+
+                                                             *vim.fs.exists()*
+Use |uv.fs_stat()| to check a file's type, and whether it exists.
+
+Example: >lua
+  if vim.uv.fs_stat(file) then
+    vim.print("file exists")
+  end
+<
+
+
 vim.fs.basename({file})                                    *vim.fs.basename()*
     Return the basename of the given path
 
diff --git a/runtime/lua/vim/fs.lua b/runtime/lua/vim/fs.lua
@@ -1,3 +1,15 @@
+--- @brief <pre>help
+--- *vim.fs.exists()*
+--- Use |uv.fs_stat()| to check a file's type, and whether it exists.
+---
+--- Example:
+---
+--- >lua
+---   if vim.uv.fs_stat(file) then
+---     vim.print("file exists")
+---   end
+--- <
+
 local uv = vim.uv
 
 local M = {}