RFR: 8274071: Clean up java.lang.ref comments and documentation

Tue Sep 21 13:23:50 UTC 2021

On Tue, 21 Sep 2021 12:05:27 GMT, Pavel Rappo <prappo at openjdk.org> wrote:

> This PR fixes an inline comment typo and reduces "overlinking" in a doc comment in `java.lang.ref.Reference`. Overlinking happens because the `reachabilityFence` method:
>  * Links `package-summary.html#reachability` twice.
>  * Refers to JLS 12.6 twice: once from a block tag and once from an inline tag.

Marked as reviewed by rriggs (Reviewer).

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

PR: https://git.openjdk.java.net/jdk/pull/5609