This Bugzilla instance is a read-only archive of historic NetBeans bug reports. To report a bug in NetBeans please follow the project's instructions for reporting issues.

Bug 229081

Summary:	Changes to support the updated doctrees API
Product:	java	Reporter:	Jan Lahoda <jlahoda>
Component:	Source	Assignee:	apireviews <apireviews>
Status:	NEW ---
Severity:	normal	CC:	ralphbenjamin
Priority:	P3	Keywords:	API, API_REVIEW_FAST
Version:	7.3
Hardware:	PC
OS:	Linux
Issue Type:	ENHANCEMENT	Exception Reporter:

Description Jan Lahoda 2013-04-26 14:18:42 UTC

We would like to use the javac's DocTrees APIs to gain structural access to javadoc, for use by various Java editing, search and transformation features. In order to do so, we need some enhancements in the java.source APIs as well. The overall changes are:
-adding CompilationInfo.getDocTrees similar to getTrees, but returning DocTrees.
-adding DocTreePathHandle - depends on DocTreePath which is not part of the javac APIs at this moment, see this webrev for a patch that introduces it:
http://deadlock.netbeans.org/hudson/job/prototypes-code_analysis/lastSuccessfulBuild/artifact/jdk8_doctrees.patch
-enhancing TreeMaker with ability to create DocTrees, and adding WorkingCopy.rewrite to actually rewrite the DocTrees
-adding a handful of utility methods into TreeUtilities

The full up-to-date patch is available here (please look for changes in java.source/.../api/... to the changes in the APIs):
http://deadlock.netbeans.org/hudson/job/prototypes-code_analysis/lastSuccessfulBuild/artifact/jdk8_doctrees.patch

Thanks for the review.

Comment 1 Ralph Ruijs 2013-04-26 14:44:11 UTC

Other included changes are:
- enhancing RefactoringVisitor with the ability to visit DocTree nodes