Details
-
Enhancement
-
Resolution: Fixed
-
P3
-
9
Description
Similar to the proposal in JDK-8149110, we should generalize the doclint options.
The proposal is to always set "-Xdoclint:all/protected -Xdoclint/package:java.*,javax.*" for all java code, and where this triggers warnings, add e.g.
java.management_DISABLED_WARNINGS_doclint := reference
to get "-Xdoclint:all/protected,-reference" or
jdk.compiler_DISABLED_WARNINGS_doclint_packages := com.sun.tools.*
to get "-Xdoclint/package:-com.sun.tools.*"
The proposal is to always set "-Xdoclint:all/protected -Xdoclint/package:java.*,javax.*" for all java code, and where this triggers warnings, add e.g.
java.management_DISABLED_WARNINGS_doclint := reference
to get "-Xdoclint:all/protected,-reference" or
jdk.compiler_DISABLED_WARNINGS_doclint_packages := com.sun.tools.*
to get "-Xdoclint/package:-com.sun.tools.*"