Scarfski/bgfx
1
0
Fork 0
mirror of https://github.com/bkaradzic/bgfx.git synced 2026-10-04 16:15:25 +00:00
Code Issues Packages Projects Releases Wiki Activity

IDL: Added docs generator. (#3613)

Browse Source
This commit is contained in:
Branimir Karadžić
2026-02-28 14:29:20 -08:00
committed by GitHub
parent 26bae47dbe
commit c10271dc28
5 changed files with 801 additions and 406 deletions
Download Patch File Download Diff File Expand all files Collapse all files

19
scripts/idl.lua
View File

@@ -10,6 +10,7 @@ function idl.comment(c)
end
local all_types = {}
local decl_order = 0
local function copy_attribs(to, from)
if type(from) == "table" then
@@ -35,7 +36,8 @@ local function classdef(item, def)
end
local function new_type(typename)
local t = { name = typename }
decl_order = decl_order + 1
local t = { name = typename, _order = decl_order }
if #comments > 0 then
t.comments = comments
comments = {}
@@ -180,7 +182,8 @@ end
local function func(sets)
return function (_, funcname)
local f = { name = funcname , args = {} }
decl_order = decl_order + 1
local f = { name = funcname , args = {} , _order = decl_order }
if #comments > 0 then
f.comments = comments
comments = {}
@@ -243,6 +246,18 @@ idl.INT32_MAX = "INT32_MAX"
idl.UINT32_MAX = "UINT32_MAX"
idl.UINT8_MAX = "UINT8_MAX"
local all_sections = {}
idl.sections = all_sections
function idl.section(title, level)
local s = { title = title, level = level or 1 }
if #comments > 0 then
s.desc = comments
comments = {}
end
all_sections[#all_sections+1] = s
end
return setmetatable(idl , { __index = function (_, keyword)
error (tostring(keyword) .. " is invalid")
end})