Request for guidance on using possible future sets of javac options
Joseph D. Darcy
joe.darcy at oracle.com
Fri Feb 6 01:19:15 UTC 2015
As a continuation of the warnings effort, I'd like to see doclint
checking selectively enabled during the main build of the Java sources
in the jdk repo by javac.
As the name implies, the javac "-Xdoclint" argument enables structural
checking of javadoc comments by javac. For the java.* and javax.*
classes in the jdk repo which go into the Java SE docs bundle, many of
them have already been cleared of doclint warnings; in awt and swing,
about 1500 public or protected declarations are missing doc comments.
Work is underway to provide a package (or module filter) on where
doclint is applied (JDK-8071851:
Provide filtering of doclint checking based on packages). Once that
functionality is available, I'd like to compile modules like java.base with
-Xlint:all -Werror -Xdoclint:all/protected
and modules like java.desktop with
-Xlint:all -Werror -Xdoclint:all,-missing/protected
Is there a suggested way to modify make/common/SetupJavaCompilers.gmk
and other files to most easily accomplish this?
More information about the build-dev