JDK-4398224 : Introductory Thread class comments out of date with new shutdown protocol
  • Type: Bug
  • Component: core-libs
  • Sub-Component: java.lang
  • Affected Version: 1.3.0
  • Priority: P4
  • Status: Closed
  • Resolution: Not an Issue
  • OS: generic
  • CPU: generic
  • Submitted: 2000-12-14
  • Updated: 2022-11-12
  • Resolved: 2022-11-12
Related Reports
Relates :  
Description
Name: boT120536			Date: 12/14/2000


java version "1.3.0_01"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.3.0_01)
Java HotSpot(TM) Client VM (build 1.3.0_01, mixed mode)

The introductory javadoc for class Thread describes the thread lifecycle in
terms of the VM lifecycle. However with the new shutdown protocol in 1.3 these
comments are out of date. At a minimum the references to Runtime.exit should be
changed to Runtime.halt.
(Review ID: 113635) 
======================================================================

Comments
The Thread class description has been completely replaced in JDK 19 and JDK 20. It now links to the Runtime "Shutdown Sequence" section where the shutdown sequence is fully description. So I think we can close this 22 year old issue.
12-11-2022

As part of JDK-8290036, the Thread class description is will be updated to say that the shutdown sequence begins when all started non-daemon threads have terminated.
19-09-2022

WORK AROUND Name: boT120536 Date: 12/14/2000 - ======================================================================
11-06-2004