RFR: 6587699: Document DigestInputStream behavior when skip() or mark() / reset() is used [v2]

[Weijun Wang]

> Add an `@implNote` to clarify the behavior when these methods are called. A new test is added.

Weijun Wang has updated the pull request incrementally with one additional commit since the last revision:

  Brad comment

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

Changes:
  - all: https://git.openjdk.org/jdk/pull/9667/files
  - new: https://git.openjdk.org/jdk/pull/9667/files/41aa7d22..a6304352

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

  Stats: 2 lines in 1 file changed: 0 ins; 0 del; 2 mod
  Patch: https://git.openjdk.org/jdk/pull/9667.diff
  Fetch: git fetch https://git.openjdk.org/jdk pull/9667/head:pull/9667

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