JDK-4132653 : (thread spec) Thread.join() description of time to wait is misleading
  • Type: Bug
  • Component: core-libs
  • Sub-Component: java.lang
  • Affected Version: 1.2.0
  • Priority: P3
  • Status: Closed
  • Resolution: Won't Fix
  • OS: solaris_2.4
  • CPU: sparc
  • Submitted: 1998-04-27
  • Updated: 2024-04-12
  • Resolved: 2017-07-19
Description
Name: akC45999			Date: 04/27/98



Description of java.lang.Thread.join() reads:
...
Waits at most millis milliseconds for this thread to die
...

I belive it should read:
...
Waits at least millis milliseconds etc.
...

This is why:
1. if the description were true, then a JVM could 
wait zero time and still be conformant. Such implementation is useless.
2. No implementation can guarantee that a thread would resume execution
within a given period of time (one must add the time the thread waits
for a free processor), so the description is unimplementable.


======================================================================

Comments
Changing the specification is no longer possible to the extent proposed.
19-07-2017

SUGGESTED FIX http://javaweb/java/jdk/ws/libs/rev/4132653/ (plus fasttrack CCC)
07-05-2007

EVALUATION Language can be borrowed from Thread.sleep to make the join javadoc reflect practical realities.
12-04-2007