forked from enlightenment/efl
docgen: prepare generators for function doc support
This commit is contained in:
parent
d3b6ab7c2d
commit
90ab6e07f1
48
gendoc.lua
48
gendoc.lua
|
@ -162,23 +162,39 @@ local Buffer = Writer:clone {
|
||||||
|
|
||||||
-- eolian to various doc elements conversions
|
-- eolian to various doc elements conversions
|
||||||
|
|
||||||
local get_brief_doc = function(doc)
|
local get_brief_doc = function(doc1, doc2)
|
||||||
if not doc then
|
if not doc1 and not doc2 then
|
||||||
return "No description supplied."
|
return "No description supplied."
|
||||||
end
|
end
|
||||||
return doc:summary_get()
|
if not doc1 then
|
||||||
|
doc1, doc2 = doc2, doc1
|
||||||
|
end
|
||||||
|
return doc1:summary_get()
|
||||||
end
|
end
|
||||||
|
|
||||||
local get_full_doc = function(doc)
|
local get_full_doc = function(doc1, doc2)
|
||||||
if not doc then
|
if not doc1 and not doc2 then
|
||||||
return "No description supplied."
|
return "No description supplied."
|
||||||
end
|
end
|
||||||
local sum = doc:summary_get()
|
if not doc1 then
|
||||||
local desc = doc:description_get()
|
doc1, doc2 = doc2, doc1
|
||||||
if not desc then
|
|
||||||
return sum
|
|
||||||
end
|
end
|
||||||
return sum .. "\n\n" .. desc
|
local sum1 = doc1:summary_get()
|
||||||
|
local desc1 = doc1:description_get()
|
||||||
|
local edoc = ""
|
||||||
|
if doc2 then
|
||||||
|
local sum2 = doc2:summary_get()
|
||||||
|
local desc2 = doc2:description_get()
|
||||||
|
if not desc2 then
|
||||||
|
if sum2 then edoc = "\n\n" .. sum2 end
|
||||||
|
else
|
||||||
|
edoc = "\n\n" .. sum2 .. "\n\n" .. desc2
|
||||||
|
end
|
||||||
|
end
|
||||||
|
if not desc1 then
|
||||||
|
return sum1 .. edoc
|
||||||
|
end
|
||||||
|
return sum1 .. "\n\n" .. desc1 .. edoc
|
||||||
end
|
end
|
||||||
|
|
||||||
local gen_namespaces = function(v, subnspace, root)
|
local gen_namespaces = function(v, subnspace, root)
|
||||||
|
@ -301,10 +317,16 @@ local build_ref = function()
|
||||||
f:finish()
|
f:finish()
|
||||||
end
|
end
|
||||||
|
|
||||||
local write_full_doc = function(f, doc)
|
local write_full_doc = function(f, doc1, doc2)
|
||||||
f:write_raw(get_full_doc(doc))
|
f:write_raw(get_full_doc(doc1, doc2))
|
||||||
f:write_nl(2)
|
f:write_nl(2)
|
||||||
local since = doc and doc:since_get() or nil
|
local since
|
||||||
|
if doc2 then
|
||||||
|
since = doc2:since_get()
|
||||||
|
end
|
||||||
|
if not since and doc then
|
||||||
|
since = doc:since_get()
|
||||||
|
end
|
||||||
if since then
|
if since then
|
||||||
f:write_i(since)
|
f:write_i(since)
|
||||||
f:write_nl(2)
|
f:write_nl(2)
|
||||||
|
|
Loading…
Reference in New Issue