JDK-8158006 : Improve javadoc for abstract classes that application should not directly extend
  • Type: Bug
  • Component: javafx
  • Sub-Component: scenegraph
  • Affected Version: 9
  • Priority: P3
  • Status: Resolved
  • Resolution: Fixed
  • Submitted: 2016-05-26
  • Updated: 2017-05-11
  • Resolved: 2016-06-24
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
JDK 9
9Fixed
Related Reports
Blocks :  
JDK-8144585 - Encapsulate JavaFX impl_* implementation methods
Description
We need to improve specification documentation on abstract classes such as Node, Shape, Shape3D, LightBase and Camera that application can't meaningful extend and use
Comments
Changeset: a4e104ec89b8 Author: ckyang Date: 2016-06-23 23:26 -0700 URL: http://hg.openjdk.java.net/openjfx/9-dev/rt/rev/a4e104ec89b8
24-06-2016
A couple wording suggestions (they apply to all 5 classes). * Application should not extend the Node class directly. Doing so may lead to Either "Applications should..." or "An application should..." * a UnsupportedOperationException being thrown. "an ..." +1 with those changes
24-06-2016
Please review the proposed fix: http://cr.openjdk.java.net/~ckyang/JDK-8158006/webrev.00/
24-06-2016