Bug 333276

Summary:	[language support] Jsdoc support for optional parameters
Product:	[WebTools] JSDT	Reporter:	arndt
Component:	General	Assignee:	Project Inbox <jsdt.javascript-inbox>
Status:	NEW ---	QA Contact:	Chris Jaun <cmjaun>
Severity:	enhancement
Priority:	P3	CC:	cmjaun, nicolas.ternisien
Version:	unspecified	Keywords:	plan
Target Milestone:	Future
Hardware:	PC
OS:	Windows XP
URL:	http://code.google.com/p/jsdoc-toolkit/wiki/TagParam
Whiteboard:

Description arndt

2010-12-28 13:09:16 EST

Build Identifier: 20100917-0705

/**
 * @requires_js_file common/Template.js
 * 
 * @param {Object} options
 * @param {String} options.label label for the selections
 */
Class.myMethod = function(options) {
}

Results in message "JSdoc: Invalid param tag name"

See also: http://code.google.com/p/jsdoc-toolkit/wiki/TagParam

Reproducible: Always

Comment 1 arndt

2011-01-06 07:20:58 EST

Should have been:

/**
 * @param {Object} [options]
 * @param {String} [options.label] label for the selections
 */
Class.myMethod = function(options) {
}

Comment 2 Nicolas Ternisien

2013-12-05 11:21:55 EST

I confirm the bug is still valid on JSDT 3.5.1. It would be (really) nice to fix it, in order to give Eclipse a chance against its major opponents in the Web part like WebStorm for instance...