JDK 9 RFR of two fixes to make/Javadoc.gmk

Joe Darcy joe.darcy at oracle.com
Thu Jun 26 21:57:18 UTC 2014


Hello,

Two JDK 9 fixes to  make/Javadoc.gmk for review:

     JDK-8048302: Update bug reporting URL in make/Javadoc.gmk
     JDK-8048321: Enabled doclint warnings in docs build
     http://cr.openjdk.java.net/~darcy/8048302.0/

The two portions of the patch below should be clear.

The old sun.com URL for reporting bugs was retired and replaced with a 
java.com URL.

After some recent fixes in langtools, the langtools API sources are 
doclint clean, meaning the doclet, taglet, and tree API doc command 
should enforce that property using the doclint option.

The core API build is doclint clean on a few properties and those are 
also enabled by this change.

I verified a docs build succeeds with this changes.

Thanks,

-Joe

diff -r 9f96a36ef77c make/Javadoc.gmk
--- a/make/Javadoc.gmk    Tue Jun 24 20:29:52 2014 -0700
+++ b/make/Javadoc.gmk    Thu Jun 26 14:53:57 2014 -0700
@@ -118,7 +118,7 @@
  COPYRIGHT_URL = $(DOCSDIR_URL)/legal/cpyr.html

  # Url to bug filing site
-BUG_SUBMIT_URL = http://bugreport.sun.com/bugreport/
+BUG_SUBMIT_URL = http://bugreport.java.com/bugreport/

  # Common line for how to submit a bug or rfe
  BUG_SUBMIT_LINE = <a href="$(BUG_SUBMIT_URL)">Submit a bug or feature</a>
@@ -366,7 +366,7 @@
  $(COREAPI_OPTIONS_FILE): $(COREAPI_OVERVIEW)
      $(prep-target)
      @($(call OptionOnly,$(COMMON_JAVADOCFLAGS)) ; \
-      $(call OptionOnly,-Xdoclint:none) ; \
+      $(call OptionOnly,-Xdoclint:html,reference,syntax) ; \
        $(call OptionPair,-sourcepath,$(RELEASEDOCS_SOURCEPATH)) ; \
        $(call OptionPair,-encoding,ISO-8859-1) ; \
        $(call OptionPair,-tag,beaninfo:X) ; \
@@ -442,7 +442,7 @@
  $(DOCLETAPI_OPTIONS_FILE):
      $(prep-target)
      @($(call OptionOnly,$(COMMON_JAVADOCFLAGS)) ; \
-      $(call OptionOnly,-Xdoclint:none) ; \
+      $(call OptionOnly,-Xdoclint:all) ; \
        $(call OptionPair,-sourcepath,$(RELEASEDOCS_SOURCEPATH)) ; \
        $(call OptionPair,-encoding,ascii) ; \
        $(call OptionOnly,-breakiterator) ; \
@@ -499,7 +499,7 @@
  $(TAGLETAPI_OPTIONS_FILE):
      $(prep-target)
      @($(call OptionOnly,$(COMMON_JAVADOCFLAGS)) ; \
-      $(call OptionOnly,-Xdoclint:none) ; \
+      $(call OptionOnly,-Xdoclint:all) ; \
        $(call OptionPair,-sourcepath,$(RELEASEDOCS_SOURCEPATH)) ; \
        $(call OptionPair,-encoding,ascii) ; \
        $(call OptionOnly,-nonavbar) ; \
@@ -1074,7 +1074,7 @@
  $(TREEAPI_OPTIONS_FILE):
      $(prep-target)
      @($(call OptionOnly,$(COMMON_JAVADOCFLAGS)) ; \
-      $(call OptionOnly,-Xdoclint:none) ; \
+      $(call OptionOnly,-Xdoclint:all) ; \
        $(call OptionPair,-sourcepath,$(RELEASEDOCS_SOURCEPATH)) ; \
        $(call OptionPair,-encoding,ascii) ; \
        $(call OptionPair,-doctitle,$(TREEAPI_DOCTITLE)) ; \




More information about the build-dev mailing list