RFR: 8157524 Revert JarFile methods "entries" and "stream" to Java 8 behavior
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().
More information about the core-libs-dev