JDK-8172474 : javac should enable doclint checking for HTML 5
Type:Bug
Component:tools
Sub-Component:javac
Affected Version:9
Priority:P3
Status:Closed
Resolution:Fixed
Submitted:2017-01-10
Updated:2017-05-17
Resolved:2017-01-13
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.
JDK-8072945 added support for HTML into doclint and javadoc, but omitted to provide an option to enable the feature in javac.
javac should have an option to enable doclint checking for HTML 5.
Comments
For consideration, we might want to (eventually) convert to supporting
--doclint
--doclint-packages
--doclint-format
11-01-2017
We already have -Xdoclint:suboptions where suboptions is a Xlint-like list of combinations of
all, [-]accessibility, [-]html, [-]reference, [-]syntax etc
but trying to merge html5 into that looks too complicated and confusing.
The other related option is
-Xdoclint/packages:....
and so based on that, the proposed option is
-Xdoclint/format:<format>
where <format> is one of html4, html5.