Adding module-level see reference support.

This commit is contained in:
cjtallman 2015-10-16 13:34:31 -07:00
parent fe15020f76
commit b9803db8ff
2 changed files with 16 additions and 1 deletions

View File

@ -1198,7 +1198,8 @@ end
-- and try to to resolve this.
function Module:resolve_references(modules)
local found = List()
for item in self.items:iter() do
-- Resolve see references in item. Can be Module or Item type.
local function resolve_item_references(item)
local see = item.tags.see
if see then -- this guy has @see references
item.see = List()
@ -1213,6 +1214,11 @@ function Module:resolve_references(modules)
end
end
end
resolve_item_references(self); -- Resolve module-level see references.
for item in self.items:iter() do
resolve_item_references(item); -- Resolve item-level see references.
end
-- mark as found, so we don't waste time re-searching
for f in found:iter() do
f[1].tags.see:remove_value(f[2])

View File

@ -90,6 +90,15 @@ return [==[
# if module.tags.include then
$(M(ldoc.include_file(module.tags.include)))
# end
# if module.see then
# local li,il = use_li(module.see)
<h3>See also:</h3>
<ul>
# for see in iter(module.see) do
$(li)<a href="$(ldoc.href(see))">$(see.label)</a>$(il)
# end -- for
</ul>
# end -- if see
# if module.usage then
# local li,il = use_li(module.usage)
<h3>Usage:</h3>