Clarify the specification of the
java.nio.channels.FileChannel.transferFrom method to make it clear that it returns 0 when the the source channel is at end-of-stream.
Currently, the API spec for FileChannel.transferFrom is not very clear about the return value, there are several misuse cases where users are not clear about the meaning or value of return value.
Add a clearer message in the API doc of FileChannel.transferFrom.
Add the following to the method description:
"No bytes are transferred, and zero is returned, if the source has reached end-of-stream."