Error while running jsdoc:dist task in jsdoc's path.js about grunt-jsdoc

[krampstudio]

It seems to be a jsdoc error

You can try to run it with the --debug option n. You will get the jsdoc command that is executed and try it.

[krampstudio]

I'm able to reproduce this error (it's not related to OSX, I'm running Debian).
This error occurs when the jsdoc annotations are not valid.

By instance, I've set the @constructor instead of @lends and got the exception.

For now jsdoc3 is still not stable (instead they released the 3.1 version) and very capricious with some syntaxes.

[bitgangsta]

As you said, it appears to be a bug in the upstream (jsdoc) project, as I said previously, I narrowed it down to a call to the commonPrefix() function. Basically jsdoc appaers to be taking the entire JS file, parsing it into elements/nodes and shoving those into a database in memory. Then it reads through the DB to parse it, evaluating each node.

In my case, I tried it with a normal JS file (no JSDOC comments at all). I switched to Codo to avoid the issue. It's much simpler and just works. Jsdoc is just too messy to debug between the Java and JS components.

[krampstudio]

I've opened an issue to the jsdoc google-group and will post the link once the issue is approved.

[krampstudio]

Upstream bug fixed https://groups.google.com/forum/?hl=en&fromgroups=#!topic/jsdoc-users/Za5WMc7X9iQ

[bitgangsta]

Woot! That's great @krampstudio. I will definitely try out the grunt plugin again now with jsdoc's master. Should we close this issue?