JDK-8091730 : Enable -Xdoclint:all to treat all javadoc warnings as errors
Type:Bug
Component:javafx
Sub-Component:build
Affected Version:9,10
Priority:P3
Status:Resolved
Resolution:Fixed
Submitted:2014-08-15
Updated:2017-05-18
Resolved:2017-04-20
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.
Now that we are doclint clean, we should build the FX API docs with "-Xdoclint:all" by default to treat warnings as errors and fail the build when they occur.
Comments
Changeset: 1a3f128518cd
Author: kcr
Date: 2017-04-20 09:16 -0700
URL: http://hg.openjdk.java.net/openjfx/9-dev/rt/rev/1a3f128518cd
8091730: Enable -Xdoclint:all to treat all javadoc warnings as errors
Reviewed-by: ckyang, ddhill
The JDK team has fixed all doclet errors related to building JavaFX docs in JDK 9. In order not to regress the current state of being doclint clean (which already happened once: see JDK-8178281) we should consider this for JDK 9. This will not affect the shipping bits, and is very low risk. It will make it much easier to prevent errors in the future if we do this in JDK 9, given that we are still allowing doc changes in 9.
07-04-2017
Now that we are doclint clean, I am scheduling this for JDK 10.