From the bug report:

This line in Docs.gmk is incorrect, and should be removed.

-tag version \

It incorrectly enables support for the @version tag, which should only be enabled by the (poorly-named) -version option.  (@version and -version are a similar pair to @author and -author).

A small number of java SE API files contain a very-old @version tag, and this started showing up in JavaSE docs in JDK 8. You can find these files by grepping recursively for @version.  The change that added this line is probably a side-effect of adding support for the @apiNote, @implNote, @implSpec tags.

Note that removing this line will change the Java SE API docs, reverting the handling of @version back to its original treatment of being ignored up through and including JDK 7.

Bug: https://bugs.openjdk.java.net/browse/JDK-8203366
Patch inline:
diff --git a/make/Docs.gmk b/make/Docs.gmk
--- a/make/Docs.gmk
+++ b/make/Docs.gmk
@@ -85,7 +85,6 @@
     -tag throws \
     -taglet build.tools.taglet.ModuleGraph \
     -tag since \
-    -tag version \
     -tag serialData \
     -tag factory \
     -tag see \

/Magnus

Reply via email to