--- a/src/java.base/share/classes/java/lang/ThreadGroup.java Sat Mar 10 02:58:39 2018 +0100
+++ b/src/java.base/share/classes/java/lang/ThreadGroup.java Mon Mar 12 10:04:12 2018 -0400
@@ -82,11 +82,11 @@
* Constructs a new thread group. The parent of this new group is
* the thread group of the currently running thread.
* <p>
- * The <code>checkAccess</code> method of the parent thread group is
+ * The {@code checkAccess} method of the parent thread group is
* called with no arguments; this may result in a security exception.
*
* @param name the name of the new thread group.
- * @exception SecurityException if the current thread cannot create a
+ * @throws SecurityException if the current thread cannot create a
* thread in the specified thread group.
* @see java.lang.ThreadGroup#checkAccess()
* @since 1.0
@@ -99,14 +99,14 @@
* Creates a new thread group. The parent of this new group is the
* specified thread group.
* <p>
- * The <code>checkAccess</code> method of the parent thread group is
+ * The {@code checkAccess} method of the parent thread group is
* called with no arguments; this may result in a security exception.
*
* @param parent the parent thread group.
* @param name the name of the new thread group.
- * @exception NullPointerException if the thread group argument is
- * <code>null</code>.
- * @exception SecurityException if the current thread cannot create a
+ * @throws NullPointerException if the thread group argument is
+ * {@code null}.
+ * @throws SecurityException if the current thread cannot create a
* thread in the specified thread group.
* @see java.lang.SecurityException
* @see java.lang.ThreadGroup#checkAccess()
@@ -147,13 +147,13 @@
/**
* Returns the parent of this thread group.
* <p>
- * First, if the parent is not <code>null</code>, the
- * <code>checkAccess</code> method of the parent thread group is
+ * First, if the parent is not {@code null}, the
+ * {@code checkAccess} method of the parent thread group is
* called with no arguments; this may result in a security exception.
*
* @return the parent of this thread group. The top-level thread group
- * is the only thread group whose parent is <code>null</code>.
- * @exception SecurityException if the current thread cannot modify
+ * is the only thread group whose parent is {@code null}.
+ * @throws SecurityException if the current thread cannot modify
* this thread group.
* @see java.lang.ThreadGroup#checkAccess()
* @see java.lang.SecurityException
@@ -185,8 +185,8 @@
* daemon thread group is automatically destroyed when its last
* thread is stopped or its last thread group is destroyed.
*
- * @return <code>true</code> if this thread group is a daemon thread group;
- * <code>false</code> otherwise.
+ * @return {@code true} if this thread group is a daemon thread group;
+ * {@code false} otherwise.
* @since 1.0
*/
public final boolean isDaemon() {
@@ -206,16 +206,16 @@
/**
* Changes the daemon status of this thread group.
* <p>
- * First, the <code>checkAccess</code> method of this thread group is
+ * First, the {@code checkAccess} method of this thread group is
* called with no arguments; this may result in a security exception.
* <p>
* A daemon thread group is automatically destroyed when its last
* thread is stopped or its last thread group is destroyed.
*
- * @param daemon if <code>true</code>, marks this thread group as
+ * @param daemon if {@code true}, marks this thread group as
* a daemon thread group; otherwise, marks this
* thread group as normal.
- * @exception SecurityException if the current thread cannot modify
+ * @throws SecurityException if the current thread cannot modify
* this thread group.
* @see java.lang.SecurityException
* @see java.lang.ThreadGroup#checkAccess()
@@ -230,24 +230,24 @@
* Sets the maximum priority of the group. Threads in the thread
* group that already have a higher priority are not affected.
* <p>
- * First, the <code>checkAccess</code> method of this thread group is
+ * First, the {@code checkAccess} method of this thread group is
* called with no arguments; this may result in a security exception.
* <p>
- * If the <code>pri</code> argument is less than
+ * If the {@code pri} argument is less than
* {@link Thread#MIN_PRIORITY} or greater than
* {@link Thread#MAX_PRIORITY}, the maximum priority of the group
* remains unchanged.
* <p>
* Otherwise, the priority of this ThreadGroup object is set to the
- * smaller of the specified <code>pri</code> and the maximum permitted
+ * smaller of the specified {@code pri} and the maximum permitted
* priority of the parent of this thread group. (If this thread group
* is the system thread group, which has no parent, then its maximum
- * priority is simply set to <code>pri</code>.) Then this method is
- * called recursively, with <code>pri</code> as its argument, for
+ * priority is simply set to {@code pri}.) Then this method is
+ * called recursively, with {@code pri} as its argument, for
* every thread group that belongs to this thread group.
*
* @param pri the new priority of the thread group.
- * @exception SecurityException if the current thread cannot modify
+ * @throws SecurityException if the current thread cannot modify
* this thread group.
* @see #getMaxPriority
* @see java.lang.SecurityException
@@ -280,9 +280,9 @@
* argument or one of its ancestor thread groups.
*
* @param g a thread group.
- * @return <code>true</code> if this thread group is the thread group
+ * @return {@code true} if this thread group is the thread group
* argument or one of its ancestor thread groups;
- * <code>false</code> otherwise.
+ * {@code false} otherwise.
* @since 1.0
*/
public final boolean parentOf(ThreadGroup g) {
@@ -298,11 +298,11 @@
* Determines if the currently running thread has permission to
* modify this thread group.
* <p>
- * If there is a security manager, its <code>checkAccess</code> method
+ * If there is a security manager, its {@code checkAccess} method
* is called with this thread group as its argument. This may result
- * in throwing a <code>SecurityException</code>.
+ * in throwing a {@code SecurityException}.
*
- * @exception SecurityException if the current thread is not allowed to
+ * @throws SecurityException if the current thread is not allowed to
* access this thread group.
* @see java.lang.SecurityManager#checkAccess(java.lang.ThreadGroup)
* @since 1.0
@@ -589,13 +589,13 @@
/**
* Stops all threads in this thread group.
* <p>
- * First, the <code>checkAccess</code> method of this thread group is
+ * First, the {@code checkAccess} method of this thread group is
* called with no arguments; this may result in a security exception.
* <p>
- * This method then calls the <code>stop</code> method on all the
+ * This method then calls the {@code stop} method on all the
* threads in this thread group and in all of its subgroups.
*
- * @exception SecurityException if the current thread is not allowed
+ * @throws SecurityException if the current thread is not allowed
* to access this thread group or any of the threads in
* the thread group.
* @see java.lang.SecurityException
@@ -614,13 +614,13 @@
/**
* Interrupts all threads in this thread group.
* <p>
- * First, the <code>checkAccess</code> method of this thread group is
+ * First, the {@code checkAccess} method of this thread group is
* called with no arguments; this may result in a security exception.
* <p>
- * This method then calls the <code>interrupt</code> method on all the
+ * This method then calls the {@code interrupt} method on all the
* threads in this thread group and in all of its subgroups.
*
- * @exception SecurityException if the current thread is not allowed
+ * @throws SecurityException if the current thread is not allowed
* to access this thread group or any of the threads in
* the thread group.
* @see java.lang.Thread#interrupt()
@@ -651,13 +651,13 @@
/**
* Suspends all threads in this thread group.
* <p>
- * First, the <code>checkAccess</code> method of this thread group is
+ * First, the {@code checkAccess} method of this thread group is
* called with no arguments; this may result in a security exception.
* <p>
- * This method then calls the <code>suspend</code> method on all the
+ * This method then calls the {@code suspend} method on all the
* threads in this thread group and in all of its subgroups.
*
- * @exception SecurityException if the current thread is not allowed
+ * @throws SecurityException if the current thread is not allowed
* to access this thread group or any of the threads in
* the thread group.
* @see java.lang.Thread#suspend()
@@ -712,13 +712,13 @@
/**
* Resumes all threads in this thread group.
* <p>
- * First, the <code>checkAccess</code> method of this thread group is
+ * First, the {@code checkAccess} method of this thread group is
* called with no arguments; this may result in a security exception.
* <p>
- * This method then calls the <code>resume</code> method on all the
+ * This method then calls the {@code resume} method on all the
* threads in this thread group and in all of its sub groups.
*
- * @exception SecurityException if the current thread is not allowed to
+ * @throws SecurityException if the current thread is not allowed to
* access this thread group or any of the threads in the
* thread group.
* @see java.lang.SecurityException
@@ -757,12 +757,12 @@
* group must be empty, indicating that all threads that had been in
* this thread group have since stopped.
* <p>
- * First, the <code>checkAccess</code> method of this thread group is
+ * First, the {@code checkAccess} method of this thread group is
* called with no arguments; this may result in a security exception.
*
- * @exception IllegalThreadStateException if the thread group is not
+ * @throws IllegalThreadStateException if the thread group is not
* empty or if the thread group has already been destroyed.
- * @exception SecurityException if the current thread cannot modify this
+ * @throws SecurityException if the current thread cannot modify this
* thread group.
* @see java.lang.ThreadGroup#checkAccess()
* @since 1.0
@@ -800,7 +800,7 @@
/**
* Adds the specified Thread group to this group.
* @param g the specified Thread group to be added
- * @exception IllegalThreadStateException If the Thread group has been destroyed.
+ * @throws IllegalThreadStateException If the Thread group has been destroyed.
*/
private final void add(ThreadGroup g){
synchronized (this) {
@@ -878,7 +878,7 @@
* @param t
* the Thread to be added
*
- * @throws IllegalThreadStateException
+ * @throws IllegalThreadStateException
* if the Thread group has been destroyed
*/
void add(Thread t) {
@@ -1016,29 +1016,29 @@
* does not have a specific {@link Thread.UncaughtExceptionHandler}
* installed.
* <p>
- * The <code>uncaughtException</code> method of
- * <code>ThreadGroup</code> does the following:
+ * The {@code uncaughtException} method of
+ * {@code ThreadGroup} does the following:
* <ul>
* <li>If this thread group has a parent thread group, the
- * <code>uncaughtException</code> method of that parent is called
+ * {@code uncaughtException} method of that parent is called
* with the same two arguments.
* <li>Otherwise, this method checks to see if there is a
* {@linkplain Thread#getDefaultUncaughtExceptionHandler default
* uncaught exception handler} installed, and if so, its
- * <code>uncaughtException</code> method is called with the same
+ * {@code uncaughtException} method is called with the same
* two arguments.
- * <li>Otherwise, this method determines if the <code>Throwable</code>
+ * <li>Otherwise, this method determines if the {@code Throwable}
* argument is an instance of {@link ThreadDeath}. If so, nothing
* special is done. Otherwise, a message containing the
* thread's name, as returned from the thread's {@link
* Thread#getName getName} method, and a stack backtrace,
- * using the <code>Throwable</code>'s {@link
+ * using the {@code Throwable}'s {@link
* Throwable#printStackTrace printStackTrace} method, is
* printed to the {@linkplain System#err standard error stream}.
* </ul>
* <p>
* Applications can override this method in subclasses of
- * <code>ThreadGroup</code> to provide alternative handling of
+ * {@code ThreadGroup} to provide alternative handling of
* uncaught exceptions.
*
* @param t the thread that is about to exit.