Unwrap rtypes javadoc

Extra commit suggested by @mtbc on gh-2432 to clarify limitations in the `unwrap` and `wrap` methods.
Planning on merging automatically if travis is green.

--rebase-from #2432