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

Hendrik Schreiber hschreiber at openjdk.java.net
Wed Nov 10 09:30:07 UTC 2021


> Trivial improvement.
> 
> Explicitly show how to create a `Cleaner` instance using `Cleaner.create()`.
> Repeat (again) in the code example that the `State` `Runnable `should be implemented as static class and not reference the instance to be cleaned, to make the point even more clear to those people who never read the javadoc *prose*.
> 
> I have signed the OCA a while back as [hschreiber](https://openjdk.java.net/census#hschreiber).

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>

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

Changes:
  - all: https://git.openjdk.java.net/jdk/pull/6076/files
  - new: https://git.openjdk.java.net/jdk/pull/6076/files/ba469687..3a552acc

Webrevs:
 - full: https://webrevs.openjdk.java.net/?repo=jdk&pr=6076&range=01
 - incr: https://webrevs.openjdk.java.net/?repo=jdk&pr=6076&range=00-01

  Stats: 3 lines in 1 file changed: 2 ins; 0 del; 1 mod
  Patch: https://git.openjdk.java.net/jdk/pull/6076.diff
  Fetch: git fetch https://git.openjdk.java.net/jdk pull/6076/head:pull/6076

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


More information about the core-libs-dev mailing list