P4
A DESCRIPTION OF THE PROBLEM :
Please review all the documentation for java.util.concurrent.* (and its subpackages) and whenever one is allowed to specify a timeout value, please indicate what happens if timeout==0.
For example, in the above URL, what happens if ExecutorService.awaitTermination(0, TimeUnit.MILLISECONDS) is invoked? Does this mean "wait forever until shutdown has occured" or "time out immediately without waiting for shutdown to occur"?
The specification should be clear so we are guaranteed a behavior across different platforms and JVMs.
URL OF FAULTY DOCUMENTATION :
http://java.sun.com/j2se/1.5.0/docs/api/java/util/concurrent/ExecutorService.html#awaitTermination(long,%20java.util.concurrent.TimeUnit)
###@###.### 10/14/04 08:35 GMT
Please review all the documentation for java.util.concurrent.* (and its subpackages) and whenever one is allowed to specify a timeout value, please indicate what happens if timeout==0.
For example, in the above URL, what happens if ExecutorService.awaitTermination(0, TimeUnit.MILLISECONDS) is invoked? Does this mean "wait forever until shutdown has occured" or "time out immediately without waiting for shutdown to occur"?
The specification should be clear so we are guaranteed a behavior across different platforms and JVMs.
URL OF FAULTY DOCUMENTATION :
http://java.sun.com/j2se/1.5.0/docs/api/java/util/concurrent/ExecutorService.html#awaitTermination(long,%20java.util.concurrent.TimeUnit)
###@###.### 10/14/04 08:35 GMT