RFR: 8248383: Clarify java.io.Reader.read(char[], ...) behavior for full array [v2]

[Brian Burkhalter]

> Please review this small verbiage change to specify clearly the behavior of `Reader::read(char[] cbuf)` when the length of `cbuf` is zero, and that of `Reader::read(char[] cbuf, int off, int len)` when `len` is zero.

Brian Burkhalter has updated the pull request with a new target base due to a merge or a rebase. The incremental webrev excludes the unrelated changes brought in by the merge/rebase. The pull request contains five additional commits since the last revision:

 - Merge branch 'JDK-8248383-Reader-read' of https://github.com/bplb/jdk into JDK-8248383-Reader-read
 - 8248383: Clarify java.io.Reader.read(char[], ...) behavior for full array
 - 8248383: Add test ReadIntoZeroLengthArray
 - 8248383: Fix alignment of @see tags
 - 8248383: Clarify java.io.Reader.read(char[], ...) behavior for full array

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

Changes:
  - all: https://git.openjdk.java.net/jdk/pull/1737/files
  - new: https://git.openjdk.java.net/jdk/pull/1737/files/0dc2e243..d8497f0f

Webrevs:
 - full: https://webrevs.openjdk.java.net/?repo=jdk&pr=1737&range=01
 - incr: https://webrevs.openjdk.java.net/?repo=jdk&pr=1737&range=00-01

  Stats: 35454 lines in 901 files changed: 26596 ins; 5818 del; 3040 mod
  Patch: https://git.openjdk.java.net/jdk/pull/1737.diff
  Fetch: git fetch https://git.openjdk.java.net/jdk pull/1737/head:pull/1737

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