Request for guidance on using possible future sets of javac options

Joseph D. Darcy joe.darcy at
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 mailing list