Looking ahead: how to enable doclint checking when building java.* and javax.*

[Jonathan Gibbons]

On 07/10/2013 06:38 PM, Joe Darcy wrote:
> Hello,
>
> Over on core-libs-dev, there has been a sequence of bug fixes to 
> cleanup doclint warnings and errors in the  java.* and javax.* areas 
> in JDK 8. A few weeks ago, there were over 2,000 doclint issues; 
> currently there are about 850 remaining and we're making good progress 
> slogging through the rest.
>
> Looking ahead a few weeks when we may have the happy situation of zero 
> doclint issues in JDK 8, I wanted to ask on build-dev how doclint 
> warnings and errors can be enabled via the makefiles when building the 
> java.* and javax.* sources and how doclint issues can be made fatal. 
> (Making doclint issues fatal will help discourage them from creeping 
> back in ;-)
>
> Thanks,
>
> -Joe

javac has a -Xdoclint option, similar to -Xlint that can enable warnings 
at compile time.  The hope is that engineers will enable that in their 
compilation environment and fix doc comment errors at the same time as 
their compilation errors.

-- Jon