Request for guidance on using possible future sets of javac options

[Joseph D. Darcy]

Hello,

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 
-XdoclintPackage:java.*;javax.*

and modules like java.desktop with

     -Xlint:all -Werror -Xdoclint:all,-missing/protected 
-XdoclintPackage:java.*;javax.*

Is there a suggested way to modify make/common/SetupJavaCompilers.gmk 
and other files to most easily accomplish this?

Thanks,

-Joe