RFR: JDK-8260694: (fc) Add apiNote to FileChannel.transferFrom to better describe "no bytes available" case [v4]

[Hamlin Li]

> We'd better put more detailed messages in FileChannel.transferFrom/transferTo that it will not return -1, as we met several cases where developers of framework/program assume that it will return -1 on some error conditions, e.g. EOF of src Channel of transferFrom.
> 
> please check more details in JDK-8260486, and discussion in https://mail.openjdk.java.net/pipermail/nio-dev/2021-January/008094.html

Hamlin Li has updated the pull request incrementally with one additional commit since the last revision:

  JDK-8260694: (fc) Add apiNote to FileChannel.transferFrom to better describe "no bytes available" case

-------------

Changes:
  - all: https://git.openjdk.java.net/jdk/pull/2329/files
  - new: https://git.openjdk.java.net/jdk/pull/2329/files/b198ce68..b9ab224f

Webrevs:
 - full: https://webrevs.openjdk.java.net/?repo=jdk&pr=2329&range=03
 - incr: https://webrevs.openjdk.java.net/?repo=jdk&pr=2329&range=02-03

  Stats: 6 lines in 1 file changed: 0 ins; 5 del; 1 mod
  Patch: https://git.openjdk.java.net/jdk/pull/2329.diff
  Fetch: git fetch https://git.openjdk.java.net/jdk pull/2329/head:pull/2329

PR: https://git.openjdk.java.net/jdk/pull/2329