This issue has been created as a result of reviewing the change for JDK-8213490 here: http://mail.openjdk.java.net/pipermail/net-dev/2018-November/011948.html

It looks like the draft [1] referred from the javadoc has been superseded by an RFC [2]. This bug is filed to investigate whether or not the reference can be updated from:

 * <p> The textual representation of IPv6 addresses as described above can be
 * extended to specify IPv6 scoped addresses. This extension to the basic
 * addressing architecture is described in [draft-ietf-ipngwg-scoping-arch-04.txt].

to:

 * <p> The textual representation of IPv6 addresses as described above can be
 * extended to specify IPv6 scoped addresses. This extension to the basic
 * addressing architecture is described in
 * <a href="https://tools.ietf.org/html/rfc4007">
 * <i>RFC&nbsp;4007: IPv6 Scoped Address Architecture</i></a>.

Is that RFC an actual successor of that draft? Won't this (seemingly innocuous) update entail a spec change? If the answer to both questions is YES, then the javadoc should be updated.

-------------------------------------------------------------------------------
[1] https://tools.ietf.org/html/draft-ietf-ipngwg-scoping-arch-04
[2] https://tools.ietf.org/html/rfc4007