RFR: 8282648: Problems due to conflicting specification of Inflater::inflate(..) and InflaterInputStream::read(..) [v2]

[Volker Simonis]

On Mon, 28 Mar 2022 18:23:46 GMT, Lance Andersen <lancea at openjdk.org> wrote:

>> I think this require a bit of word smithing. If the return value is 'n' then it should make it clear that the values in elements b[off + n] to b[off + len - 1] are undefined, their values may or may have been changed by the inflate/read operation. For completeness, the expectation for when inflate fails should be specified too, the contents of b[off] to b[off + len - 1] will be undefined.
>
> Hi Volker, 
> 
> I believe you are heading in the right direction.  I agree with Alan and Jai that we could use a bit more clarification

Thanks for your comments. I've updated the API-doc according to your recommendations. Please feel free to propose new/better wording :)

I'll wait with updating the CSR until we reach final agreement in this PR.

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

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