Show @return in scaladoc hovers

Fixes #1002312
Yes, in `PresentationCompilerDocTest`. @mlangc please add a test.