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

[Paul Sandoz]

> 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.