JDK-8169608 : Compiler Tree API's Doctrees.getDocTreePath needs to accept a PackageElement
  • Type: Bug
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 9
  • Priority: P3
  • Status: Closed
  • Resolution: Fixed
  • OS: generic
  • CPU: generic
  • Submitted: 2016-11-13
  • Updated: 2017-05-17
  • Resolved: 2017-01-19
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 10 JDK 9
10Fixed 9 b154Fixed
Related Reports
Relates :  
JDK-8157611 - field visiblePackages is null for the unnamed module producing NPE when accessed
Relates :  
JDK-8132096 - Augment the Compiler Tree API to support the new Simplified Doclet API
Relates :  
JDK-8173068 - ElementUtils getPackageElement does not allow for an unnamed package
Description
The API getDocTreePath(FileObject fileObject) was added earlier, this allowed a way access the parsed document comments in a package.html file. 

However, this API does not go far enough, as the user has to maintain a mapping of the package FileObject to the DocTreePath. It will be far more efficient If the API instead took in a PackageElement,and stored that in the synthetic JCCompilationUnit, thus eliminate additional mappings.
Comments
This CR is marked with noreg-other, in reality the tests provided for JDK-815761, are sufficient to test this bug-fix/functionality
30-01-2017
Needs a test or noreg-something
30-01-2017