-
Enhancement
-
Resolution: Unresolved
-
P4
-
None
-
None
-
generic
-
generic
The code for classical inheritance of JavaDoc comments is located mostly in the `toolkit.util.DocFinder` class, which is used by many `*Taglet` classes to find inherited documentation. The reverse lookup is located in the `getInheritedDocTreePath` method in `toolkit.util.CommentHelper`.
Now withJDK-8324342 there is a new way to pass tags from enclosing to nested classes. This code is located in the `createWithDefaultForNested` method in `SimpleTaglet`. Additionally, this new form also needs to be handled when looking up the `DocTreePath` in `CommentHelper` (JDK-8332039).
This leads to a confusing situation where lookup of doc comments is spread over many places. Ideally, the functionality described above should be refactored and brought together to a single class/abstraction.
Now with
This leads to a confusing situation where lookup of doc comments is spread over many places. Ideally, the functionality described above should be refactored and brought together to a single class/abstraction.
- relates to
-
JDK-8285488 Improve DocFinder
-
- Resolved
-
-
JDK-8332039 Cannot invoke "com.sun.source.util.DocTreePath.getTreePath()" because "path" is null
-
- Resolved
-
-
JDK-8324342 Doclet should default @since for a nested class to that of its enclosing class
-
- Resolved
-