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

[joe darcy]

*ping*

Thanks,

-Joe

On 6/29/2015 12:16 PM, joe darcy wrote:
> 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