I think this inclusion to document the api is questionable, especially in the java documentation
It's two methods, and I think it would be better to mention them here briefly and then refer to API docs for details (yes, I know, it's scaladoc, but that is at least better than scala code).