RFR: JDK-8179361 specify -javafx option for javadoc command

Magnus Ihse Bursie magnus.ihse.bursie at oracle.com
Thu Apr 27 12:17:04 UTC 2017


If doclint is enabled for the javadoc command, it shows a bunch of 119 
errors for "unknown tag @defaultValue". This means that javadoc is not 
correctly processing the tag to generate the correct documentation.

This tag is currently enabled by the -javafx option.

Eventually, we should review JavaFX support in javadoc, but for now the 
best solution to these errors is to use the -javafx option in the 
javadoc command.

Bug: https://bugs.openjdk.java.net/browse/JDK-8179361
Patch inline:
diff --git a/make/Javadoc.gmk b/make/Javadoc.gmk
--- a/make/Javadoc.gmk
+++ b/make/Javadoc.gmk
@@ -91,7 +91,7 @@
  # The initial set of options for javadoc
  JAVADOC_OPTIONS := -XDignore.symbol.file=true -use -keywords 
-notimestamp \
      -serialwarn -encoding ISO-8859-1 -breakiterator -splitIndex 
--system none \
-    -html5 --expand-requires transitive
+    -html5 -javafx --expand-requires transitive

  # Should we add DRAFT stamps to the generated javadoc?
  ifeq ($(VERSION_IS_GA), true)

/Magnus



More information about the build-dev mailing list