diff --git a/src/java.base/share/classes/java/lang/ref/Cleaner.java b/src/java.base/share/classes/java/lang/ref/Cleaner.java index a4769e112b6..004051a9b89 100644 --- a/src/java.base/share/classes/java/lang/ref/Cleaner.java +++ b/src/java.base/share/classes/java/lang/ref/Cleaner.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 2015, 2018, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2015, 2023, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -34,7 +34,7 @@ import java.util.function.Function; /** * {@code Cleaner} manages a set of object references and corresponding cleaning actions. *
- * Cleaning actions are {@link #register(Object object, Runnable action) registered} + * Cleaning actions are {@linkplain #register(Object object, Runnable action) registered} * to run after the cleaner is notified that the object has become * phantom reachable. * The cleaner uses {@link PhantomReference} and {@link ReferenceQueue} to be @@ -87,7 +87,7 @@ import java.util.function.Function; *
{@code * public class CleaningExample implements AutoCloseable { * // A cleaner (preferably one shared within a library, - // but for the sake of example, a new one is created here) + * // but for the sake of example, a new one is created here) * private static final Cleaner cleaner = Cleaner.create(); * * // State class captures information necessary for cleanup. @@ -162,9 +162,10 @@ public final class Cleaner { * to process the phantom reachable objects and to invoke cleaning actions. * The {@linkplain java.lang.Thread#getContextClassLoader context class loader} * of the thread is set to the - * {@link ClassLoader#getSystemClassLoader() system class loader}. + * {@linkplain ClassLoader#getSystemClassLoader() system class loader}. * The thread has no permissions, enforced only if a - * {@link java.lang.System#setSecurityManager(SecurityManager) SecurityManager is set}. + * {@linkplain java.lang.System#setSecurityManager(SecurityManager) + * {@code SecurityManager} is set}. ** The cleaner terminates when it is phantom reachable and all of the * registered cleaning actions are complete. @@ -184,9 +185,9 @@ public final class Cleaner { * Returns a new {@code Cleaner} using a {@code Thread} from the {@code ThreadFactory}. *
* A thread from the thread factory's {@link ThreadFactory#newThread(Runnable) newThread} - * method is set to be a {@link Thread#setDaemon(boolean) daemon thread} + * method is set to be a {@linkplain Thread#setDaemon(boolean) daemon thread} * and started to process phantom reachable objects and invoke cleaning actions. - * On each call the {@link ThreadFactory#newThread(Runnable) thread factory} + * On each call the {@linkplain ThreadFactory#newThread(Runnable) thread factory} * must provide a Thread that is suitable for performing the cleaning actions. *
* The cleaner terminates when it is phantom reachable and all of the @@ -197,7 +198,7 @@ public final class Cleaner { * @return a new {@code Cleaner} * * @throws IllegalThreadStateException if the thread from the thread - * factory was {@link Thread.State#NEW not a new thread}. + * factory was {@linkplain Thread.State#NEW not a new thread}. * @throws SecurityException if the current thread is not allowed to * create or start the thread. */