clean up @return documentation
Merge pull request #557 from kedashoe/doc-fixes

clean up @return documentation