@param for varargs

[cowwoc]

Given:

/**
 * Returns the sum of all numbers passed to the function.
 * @param {...number} num - A positive or negative number.
 */
function sum(num) {
    var i = 0, n = arguments.length, t = 0;
    for (; i < n; i++) {
        t += arguments[i];
    }
    return t;
}

from http://usejsdoc.org/tags-param.html you will get "Invalid JsDoc type definition" for the @param. It looks like the varargs syntax is not recognized.

[yelworc]

Shouldn't this also allow something like this:

/**
 * ...
 * @param {function} callback function to call after the delay
 * @param {number} delay delay in ms
 * @param {...*} args arbitrary arguments for the callback function
 */
setTimeout(callback, delay)

At the moment, this results in a "jsDoc: redundant param statement" error.
FWIW, jsdoc does render this nicely.

[qfox]

@yelworc I think you're right. If type or name contains ... it should be qualified as optional. You can wrap args to brackets for now.

I've made an issue about it.

[qfox]

@yelworc Thanks for report ;-)