Community
Participate
Working Groups
Version: 1.5.1.v201307171524-7H7FFhVFC7sResSz-gpggbs Build id: 20130816211629 If I type any of the following form of JSDoc description of a typed array parameter, I get the warning: "JSdoc: Invalid param tag name". /** * @param {String[]} List of strings (1) * @param {Array.<string>} List of strings (2) * @param {Array<String>} List of strings (3) * @param {Array<String>} List of strings (4) * * * @returns {String[]} List of strings (5) */ var my = function(param) { return param; }; Is there any reason for this, considering all these forms are legal from the JSDoc point of view? http://code.google.com/p/jsdoc-toolkit/wiki/TagParam http://usejsdoc.org/tags-type.html
No reason. Looks like a problem with the jsdoc validation.
Good to know this is an unexpected behavior! By the way, are JSDoc comments used to improve the validation and autocompletion of the Javascript code?
Yes, in some cases JSdoc comments are used to infer what type a variable may be, what functions return and types of their parameters.