RFR: 8283779: Clarify API documentation of NetworkInterface with respect to configuration changes [v9]

[Daniel Fuchs]

On Tue, 3 Sep 2024 18:04:34 GMT, Daniel Fuchs <dfuchs at openjdk.org> wrote:

>> Please find here a change that adds a few `@apiNote` and `@implNote` to `NetworkInterface` to clarify user expectation and implementation.
>
> Daniel Fuchs has updated the pull request incrementally with one additional commit since the last revision:
> 
>   Review feedback

src/java.base/share/classes/java/net/NetworkInterface.java line 52:

> 50:  * specific number that identifies the interface. The network
> 51:  * configuration may change during the lifetime of the JVM:
> 52:  * typically, the set of IP addresses assigned to a network

Suggestion:

 * configuration may change during the lifetime of the JVM.
 * For example, the set of IP addresses assigned to a network

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

PR Review Comment: https://git.openjdk.org/jdk/pull/20822#discussion_r1746995863