Clean up the #read javadoc.

By being more consistent in parameter naming, we can inherit more javadoc.

Also fix a couple of javadoc warnings in KnownFailure and DataInputStream.

Change-Id: I778f40469404fb50c51cdb1068970974f923180c
Merge "Clean up the #read javadoc."
Merge https://android.googlesource.com/platform/libcore into jb-devel