Scarfski/bgfx
1
0
Fork 0
mirror of https://github.com/bkaradzic/bgfx.git synced 2026-08-14 23:29:40 +00:00
Code Issues Packages Projects Releases Wiki Activity

IDL: Improve docs. (#3614)

Browse Source
This commit is contained in:
Branimir Karadžić
2026-02-28 15:34:30 -08:00
committed by GitHub
parent c10271dc28
commit 3e6455e6b0
4 changed files with 101 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

28
scripts/codegen.lua
View File

@@ -708,7 +708,19 @@ function codegen.doxygen_type(doxygen, func, cname)
end
end
result[#result+1] = "///"
return table.concat(result, "\n")
-- Collapse consecutive empty comment lines (///) into at most one.
local collapsed = {}
for _, line in ipairs(result) do
local is_empty = (line == "///" or line == "/// ")
local prev_empty = #collapsed > 0 and (collapsed[#collapsed] == "///" or collapsed[#collapsed] == "/// ")
if is_empty and prev_empty then
-- skip duplicate empty comment line
else
collapsed[#collapsed+1] = line
end
end
return table.concat(collapsed, "\n")
end
function codegen.doxygen_ctype(doxygen, func)
@@ -728,7 +740,19 @@ function codegen.doxygen_ctype(doxygen, func)
end
result[#result+1] = " *"
result[#result+1] = " */"
return table.concat(result, "\n")
-- Collapse consecutive empty comment lines ( *) into at most one.
local collapsed = {}
for _, line in ipairs(result) do
local is_empty = (line == " *" or line == " * ")
local prev_empty = #collapsed > 0 and (collapsed[#collapsed] == " *" or collapsed[#collapsed] == " * ")
if is_empty and prev_empty then
-- skip duplicate empty comment line
else
collapsed[#collapsed+1] = line
end
end
return table.concat(collapsed, "\n")
end
local enum_temp = [[