RFR: 8157524 Revert JarFile methods "entries" and "stream" to Java 8 behavior

Steve Drach steve.drach at oracle.com
Tue Jul 19 16:33:49 UTC 2016


It doesn’t add that much value.  I’ll take it out.

> On Jul 19, 2016, at 1:12 AM, Paul Sandoz <paul.sandoz at oracle.com> wrote:
> 
> 
>> On 18 Jul 2016, at 20:06, Steve Drach <steve.drach at oracle.com> wrote:
>> 
>>> 
>>> I would be inclined to drop the note for Enumeration and add a @see tag referencing the Stream returned method.
>> 
>> I actually had to use the versionedEntries method for jdeps.  Because of that and because I don’t see the harm with leaving it in, I left it in.
>> 
> 
> You are implicitly making reference in the @apiNote note of entries() to a method in the @apiNote of stream()
> 
> 533      *         Iterator<JarEntry> it = versionedStream(jf).iterator();
> 
> That’s quite confusing. If you wanna keep the @apiNote in entires i recommend keep the two notes independent, and also add a @see to stream().
> 
> Paul.



More information about the core-libs-dev mailing list