Details
-
Bug
-
Resolution: Fixed
-
P5
-
7
-
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.
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
- duplicates
-
JDK-8062802 Typo in java.lang.Thread#destroy() API documentation
-
- Closed
-