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

Bug 483618

Summary: Merge JSDoc tag and tag template proposals
Product: [ECD] Orion Reporter: Curtis Windatt <curtis.windatt.public>
Component: JS ToolsAssignee: Curtis Windatt <curtis.windatt.public>
Status: RESOLVED FIXED QA Contact:
Severity: normal    
Priority: P3    
Version: 10.0   
Target Milestone: 11.0   
Hardware: PC   
OS: Windows 7   
Whiteboard:

Description Curtis Windatt CLA 2015-12-03 15:27:40 EST
Currently JSDoc completions will list all of the tags as completions (essentially keyword completions).  For some of the tags we also provide templates, mostly to set the cursor at the right location.  Since we sort the templates in a separate section, they are really easy to miss.

A simple improvement to this would be to always use the templates and never provide separate proposals.  We would also need to fix the template hover doc to show actual doc rather than 'Template source: ...'.
Comment 1 Curtis Windatt CLA 2015-12-03 15:37:38 EST
http://git.eclipse.org/c/orion/org.eclipse.orion.client.git/commit/?id=2eb9cf2248d846e9b00b6593a35b8fc96fdc9c6f
Fixed in master

Another improvement we can make would be to look at the other characters on the line and choose an appropriate spot for the cursor and decide whether aspects of the template are appropriate.  Such as when the user already has {type} on the same line and the @param completion adds a second {type}.  This is something we can look at once we have parsed comments with locations from Doctrine.