RFR: 8369854: (ch) Refine specification of behavior of {Gathering,Writable}ByteChannel.write [v2]

[Brian Burkhalter]

> Modify the specification of the `write` methods of `WritableByteChannel` and `GatheringByteChannel` in the `java.nio.channels` package to emphasize that each method invocation returns only the number of bytes written in that invocation and that `write` might have to be invoked more than once for all requested bytes to be written.

Brian Burkhalter has updated the pull request incrementally with one additional commit since the last revision:

  8369854: Address reviewer comments

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

Changes:
  - all: https://git.openjdk.org/jdk/pull/27833/files
  - new: https://git.openjdk.org/jdk/pull/27833/files/bb404a8f..c2da93a2

Webrevs:
 - full: https://webrevs.openjdk.org/?repo=jdk&pr=27833&range=01
 - incr: https://webrevs.openjdk.org/?repo=jdk&pr=27833&range=00-01

  Stats: 8 lines in 2 files changed: 0 ins; 2 del; 6 mod
  Patch: https://git.openjdk.org/jdk/pull/27833.diff
  Fetch: git fetch https://git.openjdk.org/jdk.git pull/27833/head:pull/27833

PR: https://git.openjdk.org/jdk/pull/27833