On Fri, 22 Oct 2021 08:03:34 GMT, Hendrik Schreiber <hschrei...@openjdk.org> wrote:
> 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). As for compilable code, this may be a good place to use Snippets. [JEP 413: Code Snippets in Java API Documentation](https://openjdk.java.net/jeps/413) They are new but may offer some value add here. Good standalone examples aren't always good programming practice. ------------- PR: https://git.openjdk.java.net/jdk/pull/6076