JDK 9 RFR of JDK-8080722: Revisit how to check for doclint reference warning during the build

joe darcy joe.darcy at oracle.com
Mon Jun 29 19:16:44 UTC 2015


Hello,

A fix for

     JDK-8129909: Add -Xdoclint/packages: to javadoc
     https://bugs.openjdk.java.net/browse/JDK-8129909

is working its way through the system, in anticipation of that fix, 
please view my fix for

     JDK-8080722: Revisit how to check for doclint reference warning 
during the build

Patch below:

--- a/make/Javadoc.gmk    Tue Jun 23 15:11:56 2015 +0200
+++ b/make/Javadoc.gmk    Mon Jun 29 12:11:03 2015 -0700
@@ -410,7 +410,8 @@
      $(prep-target)
      @($(call COMMON_JAVADOCFLAGS) ; \
            $(call COMMON_JAVADOCTAGS) ; \
-          $(call OptionOnly,-Xdoclint:none) ; \
+          $(call OptionOnly,-Xdoclint:reference) ; \
+          $(call OptionOnly,-Xdoclint/package:-org.omg.*) ; \
        $(call OptionPair,-sourcepath,$(RELEASEDOCS_SOURCEPATH)) ; \
        $(call OptionPair,-encoding,ISO-8859-1) ; \
        $(call OptionOnly,-splitIndex) ; \

As discussed on jdk9-dev, this fix will allow JEP 212 to be completed.

http://mail.openjdk.java.net/pipermail/jdk9-dev/2015-June/002343.html

Just to be clear, I would not push the fix for JDK-8080722 until the fix 
for JDK-8080722 is in the jdk 9 dev forest. Additionally, I'll verify 
the build still works at that point with the patch above.

Thanks,

-Joe



More information about the build-dev mailing list