Bug 333712 - [misc] JSDoc is not shown for the class properties
Summary: [misc] JSDoc is not shown for the class properties
Status: NEW
Alias: None
Product: JSDT
Classification: WebTools
Component: General (show other bugs)
Version: 3.2.2   Edit
Hardware: PC Windows 7
: P3 normal (vote)
Target Milestone: Future   Edit
Assignee: Project Inbox CLA
QA Contact: Chris Jaun CLA
URL:
Whiteboard:
Keywords: plan
Depends on:
Blocks:
 
Reported: 2011-01-06 18:43 EST by Eugene Ostroukhov CLA
Modified: 2015-09-08 04:26 EDT (History)
2 users (show)

See Also:

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description Eugene Ostroukhov CLA 2011-01-06 18:43:48 EST 
JSDoc is not shown for properties (i.e. try window.closed that has proper JSDoc in the JSDT library file). I was using CVS head so this issue is not the same as #327191.
Comment 1 Adrian Price CLA 2015-09-08 04:26:42 EDT 
This concurs with my own observations in Eclipse 4.5 / JSDT org.eclipse.wst.jsdt.feature.feature.group_1.6.200.v201505071819, namely that:

- JSDoc for types and methods, generated on-the-fly from library or workspace sources as appropriate, IS displayed in 1.) hovers, 2.) the JSDoc Documentation view and 3.) content assist's additional info panel.

- Similarly, JSDoc for member properties IS displayed in hovers and the Documentation view but NOT in the content assist additional info panel.

Debugging reveals that this is because the SourceField representing the property has a sourceRange that starts at the first character of the executable expression that defines the property rather than the /** opening delimiter of the associated JSDoc comment. I see that a very similar problem was fixed by https://bugs.eclipse.org/bugs/show_bug.cgi?id=278904 in the case of a ResolvedSourceField, but the IMembers I observed during debugging were all instances of SourceField not ResolvedSourceField.