JDK-8213956 : javadoc crash using {@index} in doc-files file
  • Type: Bug
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 12
  • Priority: P2
  • Status: Resolved
  • Resolution: Fixed
  • Submitted: 2018-11-15
  • Updated: 2018-12-05
  • Resolved: 2018-11-26
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
JDK 12
12 b22Fixed
Related Reports
Blocks :  
Relates :  
Description
Extract from output:
javadoc: error - An internal exception has occurred. 
	(javax.lang.model.element.UnknownElementException: Unknown element: jdk.javadoc.internal.doclets.toolkit.DocFileElement@6b456fb6)
Please file a bug against the javadoc tool via the Java bug reporting page
(http://bugreport.java.com) after checking the Bug Database (http://bugs.java.com)
for duplicates. Include error messages and the following diagnostic in your report. Thank you.
javax.lang.model.element.UnknownElementException: Unknown element: jdk.javadoc.internal.doclets.toolkit.DocFileElement@6b456fb6
	at java.compiler.interim/javax.lang.model.util.AbstractElementVisitor6.visitUnknown(AbstractElementVisitor6.java:125)
	at jdk.javadoc.interim/jdk.javadoc.internal.doclets.toolkit.DocletElement.accept(DocletElement.java:75)
	at java.compiler.interim/javax.lang.model.util.AbstractElementVisitor6.visit(AbstractElementVisitor6.java:106)
	at jdk.javadoc.interim/jdk.javadoc.internal.doclets.formats.html.TagletWriterImpl.createAnchorAndSearchIndex(TagletWriterImpl.java:463)
	at jdk.javadoc.interim/jdk.javadoc.internal.doclets.formats.html.TagletWriterImpl.indexTagOutput(TagletWriterImpl.java:119)
	at jdk.javadoc.interim/jdk.javadoc.internal.doclets.toolkit.taglets.IndexTaglet.getTagletOutput(IndexTaglet.java:52)
	at jdk.javadoc.interim/jdk.javadoc.internal.doclets.toolkit.taglets.TagletWriter.getInlineTagOutput(TagletWriter.java:287)
	at jdk.javadoc.interim/jdk.javadoc.internal.doclets.formats.html.HtmlDocletWriter$2.visitIndex(HtmlDocletWriter.java:1480)

The trigger is using {@index} inside an HTML file in a doc-files subdirectory.
Comments
DocFileElement should override Element.visit to redispatch to the enclosing element.
15-11-2018