Issue | Fix Version | Assignee | Priority | Status | Resolution | Resolved In Build |
---|---|---|---|---|---|---|
JDK-8272226 | jfx18 | Kevin Rushforth | P3 | Resolved | Fixed |
The Javadoc HTML table for a class is messed up if any of the method documentation contains {@inheritDoc} tag.
This is specifically observed with openjfx17 javadoc, which are built with JDK 16.
It is not observed with openjfx16 javadoc which were build with JDK 15.
This came up during review ofJDK-8250590.
See - https://github.com/openjdk/jfx/pull/589#issuecomment-888949660
It looks like this is the result of a javadoc tool bug that was introduced in JDK 16, although even in earlier versions of the JDK, the table has some problems with styling on the rows with overridden methods.
This is specifically observed with openjfx17 javadoc, which are built with JDK 16.
It is not observed with openjfx16 javadoc which were build with JDK 15.
This came up during review of
See - https://github.com/openjdk/jfx/pull/589#issuecomment-888949660
It looks like this is the result of a javadoc tool bug that was introduced in JDK 16, although even in earlier versions of the JDK, the table has some problems with styling on the rows with overridden methods.
- backported by
-
JDK-8272226 Javadoc "Method Summary" table is misaligned if overridden JDK method has {@inheritDoc} tag
- Resolved
- blocks
-
JDK-8271083 ☂ Missing documentation in JavaFX API
- Resolved
- relates to
-
JDK-8157000 Do not generate javadoc for overridden method with no spec change
- Resolved
-
JDK-8227765 {@inheritDoc} does not work for methods inherited from the JDK
- Open
-
JDK-8250590 Classes and methods in the javafx.css package are missing documentation
- Resolved
(2 links to)