q66 pushed a commit to branch master. http://git.enlightenment.org/core/efl.git/commit/?id=a8eb31f146adb8f3bc06966f86e9cf328eb7607d
commit a8eb31f146adb8f3bc06966f86e9cf328eb7607d Author: Daniel Kolesa <[email protected]> Date: Mon Jul 11 16:03:53 2016 +0100 docs: generate proper descriptions for structs and enums --- src/scripts/elua/apps/docgen/gendoc.lua | 36 +++++++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) diff --git a/src/scripts/elua/apps/docgen/gendoc.lua b/src/scripts/elua/apps/docgen/gendoc.lua index c55de3b..2943aaa 100644 --- a/src/scripts/elua/apps/docgen/gendoc.lua +++ b/src/scripts/elua/apps/docgen/gendoc.lua @@ -1597,6 +1597,10 @@ local build_alias = function(tp) write_tsigs(f, tp) + f:write_h("Description", 3) + write_full_doc(f, tp:documentation_get()) + f:write_nl(2) + f:finish() end @@ -1606,6 +1610,22 @@ local build_struct = function(tp) write_tsigs(f, tp) + f:write_h("Description", 3) + write_full_doc(f, tp:documentation_get()) + f:write_nl(2) + + f:write_h("Fields", 3) + + local arr = {} + for fl in tp:struct_fields_get() do + local buf = Buffer() + buf:write_b(fl:name_get()) + buf:write_raw(" - ", get_full_doc(fl:documentation_get())) + arr[#arr + 1] = buf:finish() + end + f:write_list(arr) + f:write_nl() + f:finish() end @@ -1615,6 +1635,22 @@ local build_enum = function(tp) write_tsigs(f, tp) + f:write_h("Description", 3) + write_full_doc(f, tp:documentation_get()) + f:write_nl(2) + + f:write_h("Fields", 3) + + local arr = {} + for fl in tp:enum_fields_get() do + local buf = Buffer() + buf:write_b(fl:name_get()) + buf:write_raw(" - ", get_full_doc(fl:documentation_get())) + arr[#arr + 1] = buf:finish() + end + f:write_list(arr) + f:write_nl() + f:finish() end --
