src/jdk.jdi/share/classes/com/sun/jdi/ThreadReference.java

rev 17275 : 8181417: Code cleanups in com.sun.jdi

@@ -1,7 +1,7 @@
 /*
- * Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1998, 2017, 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
  * under the terms of the GNU General Public License version 2 only, as
  * published by the Free Software Foundation.  Oracle designates this

@@ -22,10 +22,11 @@
  * or visit www.oracle.com if you need additional information or have any
  * questions.
  */
 
 package com.sun.jdi;
+
 import java.util.List;
 
 /**
  * A thread object from the target VM.
  * A ThreadReference is an {@link ObjectReference} with additional

@@ -35,10 +36,11 @@
  * @author Gordon Hirsch
  * @author James McIlree
  * @since  1.3
  */
 public interface ThreadReference extends ObjectReference {
+
     /** Thread status is unknown */
     public final int THREAD_STATUS_UNKNOWN  =-1;
     /** Thread has completed execution */
     public final int THREAD_STATUS_ZOMBIE = 0;
     /** Thread is runnable */

@@ -80,10 +82,11 @@
      * resumed through one of the JDI resume methods mentioned above;
      * the application in the target VM cannot resume the suspended thread
      * through {@link java.lang.Thread#resume}.
      * @throws VMCannotBeModifiedException if the VirtualMachine is read-only - see {@link VirtualMachine#canBeModified()}.
      */
+    @SuppressWarnings("javadoc")
     void suspend();
 
     /**
      * Resumes this thread. If this thread was not previously suspended
      * through {@link #suspend} or through {@link VirtualMachine#suspend},

@@ -113,10 +116,11 @@
      * @throws InvalidTypeException if <code>throwable</code> is not
      * an instance of java.lang.Throwable in the target VM.
      * @throws VMCannotBeModifiedException if the VirtualMachine is read-only - see {@link VirtualMachine#canBeModified()}.
      * @see java.lang.Thread#stop(Throwable)
      */
+    @SuppressWarnings("javadoc")
     void stop(ObjectReference throwable) throws InvalidTypeException;
 
     /**
      * Interrupts this thread unless the thread has been suspended by the
      * debugger.

@@ -388,11 +392,10 @@
      * @throws VMCannotBeModifiedException if the VirtualMachine is read-only - see {@link VirtualMachine#canBeModified()}.
      *
      * @since 1.4 */
     void popFrames(StackFrame frame) throws IncompatibleThreadStateException;
 
-
     /**
      * Force a method to return before it reaches a return
      * statement.
      * <p>
      * The method which will return early is referred to as the