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

Tue Sep 21 13:59:33 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.

Looks good.

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

Marked as reviewed by kbarrett (Reviewer).

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