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

Bug 333712

Summary: [misc] JSDoc is not shown for the class properties
Product: [WebTools] JSDT Reporter: Eugene Ostroukhov <eostroukhov>
Component: GeneralAssignee: Project Inbox <jsdt.javascript-inbox>
Status: NEW --- QA Contact: Chris Jaun <cmjaun>
Severity: normal    
Priority: P3 CC: adrianp.quatinus, dan.podwall
Version: 3.2.2Keywords: plan
Target Milestone: Future   
Hardware: PC   
OS: Windows 7   
Whiteboard:

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.