[jdk17] RFR: JDK-8225667: Clarify the behavior of System::gc w.r.t. reference processing

[Kim Barrett]

On Wed, 30 Jun 2021 18:24:24 GMT, Mandy Chung <mchung at openjdk.org> wrote:

> This spec clarification is a follow-up to [JDK-8224760](https://bugs.openjdk.java.net/browse/JDK-8224760?focusedCommentId=14268320&page=com.atlassian.jira.plugin.system.issuetabpanels%3Acomment-tabpanel#comment-14268320) w.r.t. reference processing.  Since there is no guarantee for any memory reclamation by the invocation of `System::gc`, the spec should also clarify that there is no guarantee in determining the change of reachability of any objects or any particular number of `Reference` objects be enqueued and cleared.
> 
> CSR:
>    https://bugs.openjdk.java.net/browse/JDK-8269690

Changes requested by kbarrett (Reviewer).

src/java.base/share/classes/java/lang/Runtime.java line 661:

> 659:      * the change of reachability in any particular number of objects
> 660:      * or any particular number of {@link java.lang.ref.Reference Reference}
> 661:      * objects be cleared and enqueued.

perhaps
s/number of objects or any/number of objects, or that any/
s/objects be/objects will be/

src/java.base/share/classes/java/lang/System.java line 1867:

> 1865:      * the change of reachability in any particular number of objects
> 1866:      * or any particular number of {@link java.lang.ref.Reference Reference}
> 1867:      * objects be cleared and enqueued.

Similar suggestion here as for Runtime.gc.

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

PR: https://git.openjdk.java.net/jdk17/pull/183