javac doclint checking now enabled in the JDK 9 build

[joe darcy]

Hello,

In the next iteration of JEP 212 Resolve Lint and Doclint Warnings [1], 
doclint warning checks from javac have now been enabled for several 
large modules in the JDK 9 code base, including java.base, java.desktop, 
and java.compiler. [2] [3] Consequently, since many modules are being 
built with the -Werror option to javac, the introduction of new doclint 
warnings in the enabled categories will cause a build failure in those 
modules.

This work takes advantage of recently introduced package-based filtering 
of doclint checking. [4]

Over time, the goal is to enable all doclint categories for fundamental 
modules. The "missing" category can be enabled in the desktop module 
once the missing javadoc tags are written. [5] Enabling the "reference" 
category may require changing some notions / configuration of the build 
to allow javadoc references to public elements in any module.

Cheers,

-Joe

[1] http://openjdk.java.net/jeps/212,
https://bugs.openjdk.java.net/browse/JDK-8042878

[2] 8072734: Turn on doclint checking in the build of modules in the jdk 
repo,
http://hg.openjdk.java.net/jdk9/dev/rev/ac80b5d194b1

[3] 8075035: Turn on doclint checking of modules in the langtools repo,
http://hg.openjdk.java.net/jdk9/dev/rev/bf9d30e4a0c7

[4] 8071851: Provide filtering of doclint checking based on packages,
http://hg.openjdk.java.net/jdk9/dev/langtools/rev/072008f47620

[5]    JDK-8075081: Fix missing doclint warnings in java.awt,
         JDK-8075082: Fix missing doclint warnings in java.swing and 
subpackages