On Mon, 2 Sep 2024 17:44:31 GMT, Daniel Fuchs <dfu...@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: > > Improve class level description again src/java.base/share/classes/java/net/NetworkInterface.java line 314: > 312: * The returned interface instance may reflect a snapshot of the > 313: * configuration taken at the time the instance is created. > 314: * To see updates to the configuration may, or may not, require The sentence "To see updates ..." is hard to read. How about "The network configuration may change at any time, this method may need to be invoked to obtain a more up to date view of the network interface". ------------- PR Review Comment: https://git.openjdk.org/jdk/pull/20822#discussion_r1741199965