Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-8023022

Some more typos in javadoc

    XMLWordPrintable

Details

    • Bug
    • Resolution: Fixed
    • P5
    • 9
    • 7
    • other-libs
    • b04

    Description

      FULL PRODUCT VERSION :


      A DESCRIPTION OF THE PROBLEM :
      Here is a javadoc-comment to method destroy():

      /**
           * Throws {@link NoSuchMethodError}.
           *
           * @deprecated This method was originally designed to destroy this
           * thread without any cleanup. Any monitors it held would have
           * remained locked. However, the method was never implemented.
           * If if were to be implemented, it would be deadlock-prone in
           * much the manner of {@link #suspend}. If the target thread held
           * a lock protecting a critical system resource when it was
           * destroyed, no thread could ever access this resource again.
           * 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
           */

      If if were to be implemented, it would be deadlock-prone in much the manner of {@link #suspend}. - I think " If if " should be replaced by " if it " .

      There is the same error: http://docs.oracle.com/javase/7/docs/api/java/lang/Thread.html


      REPRODUCIBILITY :
      This bug can be reproduced always.

      Attachments

        Issue Links

          Activity

            People

              igerasim Ivan Gerasimov
              webbuggrp Webbug Group
              Votes:
              0 Vote for this issue
              Watchers:
              3 Start watching this issue

              Dates

                Created:
                Updated:
                Resolved: