fix(doc-gen): correctly transform index files

[petebacondarwin]

@matsko I think this is a fix but have not written tests

[xdissent]

This bug was introduced in 86f3e41. Before that commit, all additional arguments were passed to the transform function, not just the first as seen in this PR. This will also fix #2370 I believe.

[petebacondarwin]

@xdissent - Nice spot. Sorry that was my commit! I will revert that aspect.

[xdissent]

I wasn't going to point any fingers! ;-)

[petebacondarwin]

OK, so you can now run the "few" doc-gen related specs with

grunt test:docgen

I have added a test that demonstrates the issue and a fix.

[petebacondarwin]

It uses new npm modules so you'll need to npm install first.

[matsko]

Perhaps we could also include a docs:generate command that would be called without running the tests (like jasmine-node does). This would be helpful when running on autotest:docs in the background while testing docs pages (since they have to be generated each time to test them).

[matsko]

Ohh nice you got a test written :) @petebacondarwin

[petebacondarwin]

@matsko grunt docs generates the docs without running the tests. This is why I created the new grunt task.

[matsko]

Cool. I've been using node docs/src/gen-docs.js to do that. Thanks for the heads up :)

[matsko]

@petebacondarwin the to file is still being generated. I tried it on the latest commit.

[petebacondarwin]

@matsko - can you try now? I have rebased on master.

[matsko]

Works! :)

[petebacondarwin]

Great! I think I'll merge this tonight.