The function comment block has to be attached to a type.
--- -- @module supermodule.mymodule local mymodule = {} --- -- Actually I'm not sure whether to write `#(supermodule.mymodule)` or -- just `#supermodule.mymodule`. -- -- @function [parent=#(supermodule.mymodule)] interface function mymodule.interface( foo ) end --- -- @function [parent=???] internal local function internal( bar ) end return mymodule
--- -- Actually, write `#supermodule.mymodule`. -- -- @function [parent=#supermodule.mymodule] interface -- @param foo function mymodule.interface( foo ) end