Add rest parameters syntax for multiple params

[juandopazo]

Hi!

Rest parameter syntax is coming in EcmaScript 6 (already in Firefox Nightly!). It looks like this:

function foo(param1, ...args) {
  // args is an array
}

I think it makes sense to use this syntax instead of YUIDoc's * for multiple parameters. It's easier to remember (I sometimes confuse it with Type[]) and maybe some day we'll be using it in real code. This pull request updates the docs to use ...params, and adds the option for @param {Type} ...params and @param {Type} [...params].

I added tests for this feature but I can't seem to run them from the command line. Is there anything else I should do besides running node tests\parser.js?

[juandopazo]

npm test. Obviously.

It doesn't work in my PC though. Maybe a Windows vs Linux thing.

[juandopazo]

I'm ok with a "no". I just wanted to discuss it with working code.

[okuryu]

Looks good to me. Do not need to leave to document the old format?

[okuryu]

I'd like to merge this. I just confirmed that the conflicts were resolved and passed tests on my box.

/cc @caridy

[caridy]

LGTM. Does this maintain BC? It looks like it does. Then I'm good with it.

[okuryu]

Yup, the user guide will suggests new syntax, but the parser maintains backward compatibility.

[juandopazo]

\o/

[okuryu]

I'm planning the next release v0.4.0, so this feature will be includes into that.

[yahoocla]

CLA is valid!

[juandopazo]

@okuryu I resolved the conflicts!

[okuryu]

@juandopazo Nice! I just merged, thanks!