NOJIRA Documenting method return types

Also remove irrelevant TODO as there are now tests for this refinery.
Merge pull request #149 from kehh/MinorDocumentationFixes

NOJIRA Documenting method return types