krampstudio/grunt-jsdoc

Fails on Windows

muxa opened this issue · 5 comments

muxa commented

I'm using relative paths

        jsdoc : {
            dist : {
                src: ['appv2/**/*.js'], 
                options: {
                    destination: 'doc'
                }
            }
        }

And getting the following error:

E:\Users\md\Documents\Visual Studio 2010\Projects\MyProject>grunt jsdoc
Running "jsdoc:dist" (jsdoc) task
>> An error occurs in jsdoc process:
>> 'E:\Users\md\Documents\Visual' is not recognized as an internal or external c
ommand,
>> operable program or batch file.
Warning: jsdoc failure Use --force to continue.

Aborted due to warnings.

I'll see if this is not due to the space characters in the path

I'm not able to reproduce this error, on windows 7 using the cmd.exe with grunt-jsdoc#0.3.3
Could you post the output of : grunt jsdoc --debug

muxa commented

Thanks for looking into this. Here's the output:

E:\Users\md\Documents\Visual Studio 2010\Projects\MyProject\grunt jsdoc --debug
Running "jsdoc:dist" (jsdoc) task
[D] Task source: E:\Users\md\Documents\Visual Studio 2010\Projects\MyProject\node_modules\grunt-jsdoc\tasks\jsdoc-plugin.js
[D] { private: true, destination: 'doc' }
[D] nodePath
[D] look up node_modules/jsdoc/jsdoc at node_modules/jsdoc/jsdoc
[D] look up node_modules/jsdoc/jsdoc at node_modules/grunt-jsdoc/
[D] look up node_modules/jsdoc/jsdoc at node_modules/grunt-jsdoc/node_modules/js
doc/jsdoc
[D] JAVA_HOME : C:\Program Files (x86)\Java\jre6\bin
[D] jsdoc found at : E:\Users\md\Documents\Visual Studio 2010\Projects\MyProject\node_modules\grunt-jsdoc\node_modules\jsdoc\jsdoc
[D] create destination : doc
[D] Reading option: private
[D] Reading option: destination
[D]                 > doc
[D] Running : cmd /c E:\Users\md\Documents\Visual Studio 2010\Projects\MyProject\node_modules\grunt-jsdoc\node_modules\jsdoc\jsdoc --private --destination doc appv2/js/data.js appv2/js/diagnostics.js
>> An error occurs in jsdoc process:
>> 'E:\Users\md\Documents\Visual' is not recognized as an internal or external c
ommand,
>> operable program or batch file.
Warning: jsdoc failure Use --force to continue.

Aborted due to warnings.
"Exited with: " 3

As a note for others researching this issue, I discovered this error, and after debugging it looked like it was needing Java on my path to run.

An error occurs in jsdoc process:
'java' is not recognized as an internal or external command,
operable program or batch file.

@xavisavvy don't you have either an old version of the plugin ? or the deprecated package ?
Could you post your package.json