Correctly emit return and params docs

[vegegoku]

This commit fixes the handling of @return and @param and converts them into proper typedocs @return, @param or @typeparam.