2D array @params

[chrisveness]

Please advise if I've misunderstood something, but I was expecting to be able to document a 2-d array parameter as follows:

/**
 * @param {number[][]} matrix - The matrix to be transformed.
 */
function tx(matrix) {}

However, this generates ERROR: Unable to create a Tag object for source file ... with title "param" and body "{number[][]} matrix - The matrix to be transformed.": Invalid type expression "number[][]": Expected "!", "?" or "|" but "[" found.

Is there an alternative way of indicating a 2-d array, or is this a feature request? Thx.

[hegemonic]

Yes, I believe JSDoc Toolkit 2.x supported this syntax. I agree that JSDoc 3 ought to support it as well.

The alternative is to use Closure Compiler-style notation, like this: Array.<Array.<number>> (the periods are optional).

[hegemonic]

Fixed on master. I'm publishing a new alpha to npm shortly, which will also include this fix.

Note that if you installed JSDoc by cloning the git repo or something like that, you'll need to run npm update catharsis in your JSDoc directory.