aboutsummaryrefslogtreecommitdiff
path: root/scripts/lua2dox.lua
diff options
context:
space:
mode:
authorJustin M. Keyes <justinkz@gmail.com>2023-08-03 06:14:15 -0700
committerGitHub <noreply@github.com>2023-08-03 06:14:15 -0700
commit4d859d00d13893815b6072a7bf2022dd89d5e3f8 (patch)
treee536f6b205d59ffac0444990c4e60b0cb3398a27 /scripts/lua2dox.lua
parentf1772272b4fda43c093fc495f54b5e7c11968d62 (diff)
parentb1fb04475e6fa0c44895cb6fe97b75816d74c297 (diff)
downloadrneovim-4d859d00d13893815b6072a7bf2022dd89d5e3f8.tar.gz
rneovim-4d859d00d13893815b6072a7bf2022dd89d5e3f8.tar.bz2
rneovim-4d859d00d13893815b6072a7bf2022dd89d5e3f8.zip
Merge #24351 docs
Diffstat (limited to 'scripts/lua2dox.lua')
-rw-r--r--scripts/lua2dox.lua4
1 files changed, 4 insertions, 0 deletions
diff --git a/scripts/lua2dox.lua b/scripts/lua2dox.lua
index 9a666ea629..01bb8ab57a 100644
--- a/scripts/lua2dox.lua
+++ b/scripts/lua2dox.lua
@@ -154,6 +154,8 @@ local function removeCommentFromLine(line)
return line:sub(1, pos_comment - 1), line:sub(pos_comment)
end
+--- Processes "@…" directives in a docstring line.
+---
--- @param line string
--- @param generics table<string,string>
--- @return string?
@@ -206,6 +208,8 @@ local function process_magic(line, generics)
magic = magic:gsub('^return%s+.*%((' .. type .. ')%)', 'return %1')
magic = magic:gsub('^return%s+.*%((' .. type .. '|nil)%)', 'return %1')
end
+ -- Remove first "#" comment char, if any. https://github.com/LuaLS/lua-language-server/wiki/Annotations#return
+ magic = magic:gsub('# ', '', 1)
-- handle the return of vim.spell.check
magic = magic:gsub('({.*}%[%])', '`%1`')
magic_split = vim.split(magic, ' ', { plain = true })