8248703 Clarify the behavior of java.net.NetworkInterface::equals

[Daniel Fuchs]

On 02/07/2020 14:29, Alan Bateman wrote:
> I assume the "Note" can be an @apiNote. I think that part reads okay 
> (and doesn't a CSR).

OK - I'll withdraw it and hide it away then :-)

> NetworkInterface is currently spec'ed to use phrases like "InetAddresses 
> bound to the network interface" and I think we should try to keep that 
> consistent if possible. That is, introducing the term "raw" into the 
> javadoc would require it to be defined and I don't think we need it. 
> Also some reader might think it has something to do with "raw sockets".

Good point. I was momentarily confused by the @see InetAddress.getAddress.

Webrev updated:
http://cr.openjdk.java.net/~dfuchs/webrev_8248703/webrev.01/

Is this still appropriate to push to 15 or should I rather aim at 16?

best regards,

-- daniel