# local no_spaces = ldoc.no_spaces # local use_li = ldoc.use_li # local display_name = ldoc.display_name # local iter = ldoc.modules.iter # local function M(txt,item) return ldoc.markup(txt,item,ldoc.plain) end # --local nowrap = ldoc.wrap and '' or 'nowrap'
# if ldoc.body then -- verbatim HTML as contents; 'non-code' entries $(ldoc.body) # elseif module then -- module documentation

$(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

    # for see in iter(module.see) do $(li)$(see.label)$(il) # end
# end # if module.usage then # local li,il = use_li(module.usage)

Usage

# for usage in iter(module.usage) do
$(ldoc.escape(usage))
# end # end # if module.info then

Info

    # for tag, value in module.info:iter() do
  • $(tag): $(M(value,module))
  • # end
# end
# --- 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 = show_return # for kind, items in module.kinds() do # local kitem = module.kinds:get_item(kind) # local has_description = kitem and ldoc.descript(kitem) ~= "" # kind = kind:gsub("modules.", ""):gsub(" Functions", "")

$(kind)

# if kitem then # if has_description then
$(M(ldoc.descript(kitem),kitem))
# end # if kitem.usage then

Usage

$(ldoc.prettify(kitem.usage[1]))
# end # end
# for item in items() do
$(display_name(item)) # if ldoc.prettify_files and ldoc.is_file_prettified[item.module.file.filename] then line $(item.lineno) # end
$(M(ldoc.descript(item),item)) # 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 li,il = use_li(tag)

$(custom.title or custom[1])

    # for value in iter(tag) do $(li)$(custom.format and custom.format(value) or M(value))$(il) # end # end
# end # end # if show_parms and item.params and #item.params > 0 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 # if def == true then (optional) # elseif def then = $(def) (default) # end # if item:readonly(p) then readonly # end
      $(M(item.params.map[p],item))
    • # end # if sublist then
  • # end # end
# end # 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 # end
# if i < #groups then

Or

# end # end # end # 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

    # for see in iter(item.see) do $(li)$(see.label)$(il) # end
# end # if item.usage then # local li,il = use_li(item.usage)

Usage

# for usage in iter(item.usage) do
$(ldoc.prettify(usage))
# end # end
# end -- for items
# end # 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
$(m.name) $(M(ldoc.strip_header(m.summary),m))
# end # end -- if module
Noble Engine by Mark LaCroix, Noble Robot Documentation created using LDoc $(ldoc.version). # if not module then Last updated $(ldoc.updatetime) # end