Anyway, thanks for ldoc and the very good documentation!
There is one thing I couldn't figure out, however. I want to introduce "Object" as a new type tag, so that
--- Function description
-- @treturn Object The created object
blah = function() ...
makes "Object" a link to a description of the object's structure.