Some Eclipse Foundation services are deprecated, or will be soon. Please ensure you've read this important communication.

Bug 345207

Summary:	support capture of Comments in the EDT model
Product:	z_Archived	Reporter:	Aaron Allsbrook <aallsbrook>
Component:	EDT	Assignee:	Project Inbox <edt.compiler-inbox>
Status:	NEW ---	QA Contact:
Severity:	enhancement
Priority:	P3	CC:	jspadea, lasher, margolis, pharmon, svihovec
Version:	unspecified
Target Milestone:	---
Hardware:	PC
OS:	Windows 7
Whiteboard:

Description Aaron Allsbrook

2011-05-09 16:58:36 EDT

I would like for comments that exist as part, field, and function headers to be included in the EDT model.  This would allow for documentation and reporting based on comments in the model.  

This enhancement would also allow additional documentation of code generators and visualizers with the use of comment annotations

Comment 1 Lisa Lasher

2011-06-10 15:07:48 EDT

changing the severity from Normal to Enhancement to show that this is a function request (RFE), not a bug.  This will ensure that it gets considered in our iteration planning.

Comment 2 Justin Spadea

2012-04-18 10:19:02 EDT

The lexer currently has two flags that can be enabled to capture comments:

returnLineComments
returnBlockComments

The comments will then be stored in org.eclipse.edt.compiler.core.ast.File. What might be a worthwhile approach to this enhancement would be to add another flag to the lexer that, when set, it will weave in all the comments into the AST tree after parsing, based on their offsets, instead of just adding them all to a list in File which doesn't really tell you which nodes the comments were for.