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

[Joe Darcy]

On Thu, 28 Jul 2022 17:17:28 GMT, Bradford Wetmore <wetmore at openjdk.org> wrote:

>> I'm using the "if and only if" style, which means other non-read methods will not update the message digest.
>
> My feeling still remains.  I don't recall seeing a wording construction like this except for IFF, which is well-understood.  I think it could be said more compactly with:
> 
> `This implementation only updates the message digest with data actually read from the input stream when it is on. `
> 
> Just my $0.02.

For your consideration, something like:
 "... This implementation will update the message digest if and only if the stream is on ...."

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

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