JDK-4672338 : Fix for 4063022 was not added to the API specification - spec for awt.threadgroup missing
  • Type: Bug
  • Component: client-libs
  • Sub-Component: java.awt
  • Affected Version: 1.4.0
  • Priority: P4
  • Status: Closed
  • Resolution: Cannot Reproduce
  • OS: linux
  • CPU: x86
  • Submitted: 2002-04-22
  • Updated: 2011-07-01
  • Resolved: 2011-07-01
Related Reports
Relates :  
Description
Name: jl125535			Date: 04/22/2002


FULL PRODUCT VERSION :
java version "1.4.0"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.0-b92)
Java HotSpot(TM) Client VM (build 1.4.0-b92, mixed mode)


FULL OPERATING SYSTEM VERSION :

Distribution: Debian unstable ('sid')
Libc: libc6, 2.2.5-3, as distributed with Debian
Kernel: 2.4.17

A DESCRIPTION OF THE PROBLEM :
The JDC bug ID 4063022 was fixed, but the fix required an
addition to the API specification. Specifically, the fix
introduced a new system property, "awt.threadgroup", which
is not documented in the API specification for
System.getProperties().

STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
1. Read 4063022.
2. Read the API documentation for System.getProperties().
3. Note that the API documentation does not include the fix
for 4063022.

EXPECTED VERSUS ACTUAL BEHAVIOR :
I was expecting to find a description for the property
"awt.threadgroup" somewhere in the API documentation; the
first place I looked was for the method
System.getProperties().

This bug can be reproduced always.
(Review ID: 144980) 
======================================================================

Comments
EVALUATION After the fix for 4887645, the awt.threadgroup system property is no longer used by AWT.
01-07-2011

EVALUATION We won't put that documentation into spec for System.getProperty(). Instead we should use other place for example AWT properties description which now on its way. Actually that description is in sun.awt.SunToolkit specification which in turn not a part of public API.
31-01-2006