RFR: JDK-8203366 tag added wrongly in Docs.gmk
Erik Joelsson
erik.joelsson at oracle.com
Thu May 24 17:51:57 UTC 2018
Looks good.
/Erik
On 2018-05-24 05:32, Magnus Ihse Bursie wrote:
> 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
More information about the build-dev
mailing list