src/java.base/share/classes/java/lang/Thread.java

rev 14117 : 8145468: update java.lang APIs with new deprecations
Reviewed-by: XXX

*** 888,898 ****
       *       interrupt the wait.
       *       For more information, see
       *       <a href="{@docRoot}/../technotes/guides/concurrency/threadPrimitiveDeprecation.html">Why
       *       are Thread.stop, Thread.suspend and Thread.resume Deprecated?</a>.
       */
!     @Deprecated
      public final void stop() {
          SecurityManager security = System.getSecurityManager();
          if (security != null) {
              checkAccess();
              if (this != Thread.currentThread()) {
--- 888,898 ----
       *       interrupt the wait.
       *       For more information, see
       *       <a href="{@docRoot}/../technotes/guides/concurrency/threadPrimitiveDeprecation.html">Why
       *       are Thread.stop, Thread.suspend and Thread.resume Deprecated?</a>.
       */
!     @Deprecated(since="1.2")
      public final void stop() {
          SecurityManager security = System.getSecurityManager();
          if (security != null) {
              checkAccess();
              if (this != Thread.currentThread()) {
*** 920,931 ****
       *        could be used to generate exceptions that the target thread was
       *        not prepared to handle.
       *        For more information, see
       *        <a href="{@docRoot}/../technotes/guides/concurrency/threadPrimitiveDeprecation.html">Why
       *        are Thread.stop, Thread.suspend and Thread.resume Deprecated?</a>.
       */
!     @Deprecated
      public final synchronized void stop(Throwable obj) {
          throw new UnsupportedOperationException();
      }
  
      /**
--- 920,932 ----
       *        could be used to generate exceptions that the target thread was
       *        not prepared to handle.
       *        For more information, see
       *        <a href="{@docRoot}/../technotes/guides/concurrency/threadPrimitiveDeprecation.html">Why
       *        are Thread.stop, Thread.suspend and Thread.resume Deprecated?</a>.
+      *        This method is subject to removal in a future version of Java SE.
       */
!     @Deprecated(since="1.2", forRemoval=true)
      public final synchronized void stop(Throwable obj) {
          throw new UnsupportedOperationException();
      }
  
      /**
*** 1041,1053 ****
       *     If another thread ever attempted to lock this resource, deadlock
       *     would result. Such deadlocks typically manifest themselves as
       *     "frozen" processes. For more information, see
       *     <a href="{@docRoot}/../technotes/guides/concurrency/threadPrimitiveDeprecation.html">
       *     Why are Thread.stop, Thread.suspend and Thread.resume Deprecated?</a>.
       * @throws NoSuchMethodError always
       */
!     @Deprecated
      public void destroy() {
          throw new NoSuchMethodError();
      }
  
      /**
--- 1042,1055 ----
       *     If another thread ever attempted to lock this resource, deadlock
       *     would result. Such deadlocks typically manifest themselves as
       *     "frozen" processes. For more information, see
       *     <a href="{@docRoot}/../technotes/guides/concurrency/threadPrimitiveDeprecation.html">
       *     Why are Thread.stop, Thread.suspend and Thread.resume Deprecated?</a>.
+      *     This method is subject to removal in a future version of Java SE.
       * @throws NoSuchMethodError always
       */
!     @Deprecated(since="1.5", forRemoval=true)
      public void destroy() {
          throw new NoSuchMethodError();
      }
  
      /**
*** 1081,1091 ****
       *   deadlocks typically manifest themselves as "frozen" processes.
       *   For more information, see
       *   <a href="{@docRoot}/../technotes/guides/concurrency/threadPrimitiveDeprecation.html">Why
       *   are Thread.stop, Thread.suspend and Thread.resume Deprecated?</a>.
       */
!     @Deprecated
      public final void suspend() {
          checkAccess();
          suspend0();
      }
  
--- 1083,1093 ----
       *   deadlocks typically manifest themselves as "frozen" processes.
       *   For more information, see
       *   <a href="{@docRoot}/../technotes/guides/concurrency/threadPrimitiveDeprecation.html">Why
       *   are Thread.stop, Thread.suspend and Thread.resume Deprecated?</a>.
       */
!     @Deprecated(since="1.2")
      public final void suspend() {
          checkAccess();
          suspend0();
      }
  
*** 1107,1117 ****
       *     which has been deprecated because it is deadlock-prone.
       *     For more information, see
       *     <a href="{@docRoot}/../technotes/guides/concurrency/threadPrimitiveDeprecation.html">Why
       *     are Thread.stop, Thread.suspend and Thread.resume Deprecated?</a>.
       */
!     @Deprecated
      public final void resume() {
          checkAccess();
          resume0();
      }
  
--- 1109,1119 ----
       *     which has been deprecated because it is deadlock-prone.
       *     For more information, see
       *     <a href="{@docRoot}/../technotes/guides/concurrency/threadPrimitiveDeprecation.html">Why
       *     are Thread.stop, Thread.suspend and Thread.resume Deprecated?</a>.
       */
!     @Deprecated(since="1.2")
      public final void resume() {
          checkAccess();
          resume0();
      }
  
*** 1268,1279 ****
       * @exception  IllegalThreadStateException  if this thread is not
       *             suspended.
       * @deprecated The definition of this call depends on {@link #suspend},
       *             which is deprecated.  Further, the results of this call
       *             were never well-defined.
       */
!     @Deprecated
      public native int countStackFrames();
  
      /**
       * Waits at most {@code millis} milliseconds for this thread to
       * die. A timeout of {@code 0} means to wait forever.
--- 1270,1283 ----
       * @exception  IllegalThreadStateException  if this thread is not
       *             suspended.
       * @deprecated The definition of this call depends on {@link #suspend},
       *             which is deprecated.  Further, the results of this call
       *             were never well-defined.
+      *             This method is subject to removal in a future version of Java SE.
+      * @see        StackWalker
       */
!     @Deprecated(since="1.2", forRemoval=true)
      public native int countStackFrames();
  
      /**
       * Waits at most {@code millis} milliseconds for this thread to
       * die. A timeout of {@code 0} means to wait forever.