$(ldoc.project)

# if not ldoc.single and module then -- reference back to project index

• Index

# end # --------- contents of module ------------- # if module and not ldoc.no_summary and #module.items > 0 then

Contents

# for kind,items in module.kinds() do # if not kind:match("^ldoc_skip") then
• $(kind)
# end # end

# end # if ldoc.no_summary and module and not ldoc.one then -- bang out the functions on the side # for kind, items in module.kinds() do # if not kind:match("^ldoc_skip") then

$(kind)dasdasd

# end # for item in items() do
• $(display_name(item))
# end # if not kind:match("^ldoc_skip") then

# end # end # end # -------- contents of project ---------- # local this_mod = module and module.name # for kind, mods, type in ldoc.kinds() do # if ldoc.allowed_in_contents(type,module) then

$(no_underscores(kind))

# for mod in mods() do local name = display_name(mod) # if mod.name == this_mod then
• $(name)
# else
• $(name)
# end # end # end

# end

# if ldoc.body then -- verbatim HTML as contents; 'non-code' entries $(ldoc.body) # elseif module then -- module documentation

Module: $(module.name)

$(M(module.summary,module))

$(M(module.description,module))

# if module.tags.include then $(M(ldoc.include_file(module.tags.include))) # end # if module.see then # local li,il = use_li(module.see)

See also:

# for see in iter(module.see) do $(li)$(see.label)$(il) # end -- for

# end -- if see # if module.usage then # local li,il = use_li(module.usage)

Usage:

# for usage in iter(module.usage) do $(li)

$(ldoc.escape(usage))

$(il) # end -- for

# end -- if usage # if module.info then

Info:

# for tag, value in module.info:iter() do
• $(tag): $(M(value,module))
# end

# end -- if module.info # if not ldoc.no_summary then # -- bang out the tables of item types for this module (e.g Functions, Tables, etc) # local last_kind = "" # for kind,items in module.kinds() do # if not kind:match("^ldoc_skip") then # if last_kind ~= "" then # end

$(kind)

# end # for item in items() do # local dn = display_name(item) # if item.sanitize_type then item.sanitize_type(item, ldoc) end # if item.display_type then # else # end # end -- for items # last_kind = kind #end -- for kinds

$(dn)

$(item.display_type)

$(dn)

$(M(item.summary,item))

# if item.inherited then Inherited from $(item.baseclass) # end

#end -- if not no_summary # --- currently works for both Functions and Tables. The params field either contains # --- function parameters or table fields. # local show_return = not ldoc.no_return_or_parms # local show_parms, last_kind = show_return, "" # for kind, items in module.kinds() do # local kitem = module.kinds:get_item(kind) # local has_description = kitem and ldoc.descript(kitem) ~= "" # if not kind:match("^ldoc_skip") then # if last_kind ~= "" then # end

$(kind)

# end $(M(module.kinds:get_section_description(kind),nil)) # if kitem then # if has_description then # end # if kitem.usage then

Usage:

$(ldoc.prettify(kitem.usage[1]))

# end # end # if not kind:match("^ldoc_skip") then

# end # for item in items() do

$(display_name(item)) # if item.display_type then ($(item.display_type)) # end # if item.inherited then  · Inherited from $(item.baseclass) # end # if ldoc.prettify_files and ldoc.is_file_prettified[item.module.file.filename] then line $(item.lineno) # end

$(M(ldoc.descript(item),item)) # if show_parms and item.params and #item.params > 0 and not item.hide_params then # local subnames = module.kinds:type_of(item).subnames # if subnames then

$(subnames):

# end

# for parm in iter(item.params) do # local param,sublist = item:subparam(parm) # if sublist then
• $(sublist)$(M(item.params.map[sublist],item))
  # end # for p in iter(param) do # local name,tp,def = item:display_name_of(p), ldoc.typename(item:type_of_param(p)), item:default_of_param(p)
  • $(name) # if tp ~= '' then $(tp) # end $(M(item.params.map[p],item)) # if def == true then (optional) # elseif def then (default $(def)) # end # if item:readonly(p) then readonly # end
  # end # if sublist then
  # end # end -- for

# end -- if params # if show_return and item.retgroups then local groups = item.retgroups

Returns:

# for i,group in ldoc.ipairs(groups) do local li,il = use_li(group)

# for r in group:iter() do local type, ctypes = item:return_type(r); local rt = ldoc.typename(type) $(li) # if rt ~= '' then $(rt) # end $(M(r.text,item))$(il) # if ctypes then
# for c in ctypes:iter() do
• $(c.name) $(ldoc.typename(c.type)) $(M(c.comment,item))
# end
# end -- if ctypes # end -- for r

# if i < #groups then

Or

# end # end -- for group # end -- if returns # if show_return and item.raise then

Raises:

$(M(item.raise,item)) # end # if item.see then # local li,il = use_li(item.see)

See also:

# for see in iter(item.see) do $(li)$(see.label)$(il) # end -- for

# end -- if see # if item.usage then # local li,il = use_li(item.usage)

Usage:

# for usage in iter(item.usage) do $(li)

$(ldoc.prettify(usage))

$(il) # end -- for

# end -- if usage # if ldoc.custom_tags then # for custom in iter(ldoc.custom_tags) do # local tag = item.tags[custom[1]] # if tag and not custom.hidden then # local group_begin, group_end, row_type_begin, row_type_end, group_header = item.get_delim(custom[1])

$(custom.title or custom[1]):

<$(group_begin)> # if group_header then # for _, g in ldoc.ipairs(group_header) do $(g) # end -- for g # end -- if group_header then # for value in iter(tag) do <$(row_type_begin)>$(custom.format and custom.format(value, item, M) or M(value)) # local sub_values, sub_custom = item.get_auto_params(custom[1], value) # if sub_values then

# for _, value in ldoc.ipairs(sub_values) do
• $(sub_custom.format(value, item, M))
# end -- for auto_params

# end -- if item.auto_params # end -- for # end -- if tag # end -- iter tags # end -- ldoc.custom_tags

# end -- for items # last_kind = kind # end -- for kinds

# else -- if module; project-level contents # if ldoc.description then

$(M(ldoc.description,nil))

# end # if ldoc.full_description then

$(M(ldoc.full_description,nil))

# end # for kind, mods in ldoc.kinds() do

$(kind)

# kind = kind:lower() # for m in mods() do # end -- for modules

$(m.name)

$(M(ldoc.strip_header(m.summary),m))

# end -- for kinds # end -- if module