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