RFR: 8276700: Improve java.lang.ref.Cleaner javadocs [v2]

[Hendrik Schreiber]

On Wed, 10 Nov 2021 09:41:44 GMT, Alan Bateman <alanb at openjdk.org> wrote:

>> Hendrik Schreiber has updated the pull request incrementally with one additional commit since the last revision:
>> 
>>   Update src/java.base/share/classes/java/lang/ref/Cleaner.java
>>   
>>   Making the comment even clearer.
>>   
>>   Co-authored-by: Mandy Chung <mandy.chung at oracle.com>
>
> src/java.base/share/classes/java/lang/ref/Cleaner.java line 93:
> 
>> 91:  *
>> 92:  *        // Static state class, capturing information necessary for
>> 93:  *        // State class captures information necessary for cleanup.
> 
> I think it would be simpler to just drop L92, meaning start with "State class captures ..." rather than having "state class" and "State class" in the same sentence.

I have removed that line and also changed `in this CleaningExample` -> `in this example`, because it is obvious.

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

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