Javadoc HTML regression bug

Jonathan Gibbons jonathan.gibbons at oracle.com
Sat Jun 27 18:08:28 UTC 2020


Hi Anders,

Thank you for your message.  Yes, it's time for an update for doclint, 
to support all global attributes and new tags that might reasonably be 
used in doc comments, like `<svg>`.

I have filed JDK-8248437 for this.

Purely from a style point of view, it may be preferable to put SVG 
images in separate files in the doc-files subdirectory for the package, 
and to reference the files with an <img> element.

-- Jon

https://bugs.openjdk.java.net/browse/JDK-8248437


On 6/23/20 11:17 PM, Anders Rundgren wrote:
> Hi List,
>
> After upgrading from JDK 8 to JDK 11 javadoc began complaining on 
> valid HTML5 constructs such as the "title" attribute and the "svg" 
> element.
> The AdoptOpenJDK maintainers suggested using -Xdoclint=none but that 
> seems more like a workaround than a solution.
>
> https://github.com/AdoptOpenJDK/openjdk-support/issues/131
>
> thanx,
> Anders


More information about the javadoc-dev mailing list