Java8 Javadoc still uses html4, but "javadoc -source 8" doesn't

Wed Nov 16 13:35:29 UTC 2022

Hi,

As far as I know Html4 support was removed from Javadoc a time ago. So now Javadoc generates html5-like anchors even with “-source 8” or “-release 8” option specified. There is JDK-8187521 added TestAnchorNames.testHtml5 checking if Html5-like anchors are generated for “-source 8” option.

On the other hand, Java8’s Javadoc still supports html4 and doesn’t support html5. So it turns that  docs generated by Java8’s Javadoc are not compatible with docs generated by any other “Javadoc -release 8” because they use different types of anchors.

I haven’t found any discussion explaining that, so could anyone explain, please, if it is correct behavior or not?

- RM
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://mail.openjdk.org/pipermail/javadoc-dev/attachments/20221116/566b2a23/attachment-0001.htm>