Building documentation aborted due to warnings

[thefragebogen]

Building documentation aborted due to warnings

[dennisguse]

The issue is that jsdoc changed their command line interface while moving from 2.X to 3.X.
In 2.X they used "-d=XXX" to define the target directory and in 3.X they use "-d XXX".

Can you try: jsdoc --private -d doc thefragebogen.js?
You can also adjust the Gruntfile by removing the =: https://github.com/TheFragebogen/TheFragebogen/blob/master/Gruntfile.js#L78

[gabrielmittag]

Thanks for you help. Now it starts buliding the documentation and I think I have most of it in the "doc" folder. However, I still receive another error.

PS C:\Users\gabriel\Documents\Fragebogen\TheFragebogen> grunt doc
Running "includereplace:dist" (includereplace) task
Processed 43 files

Running "revision" task
HEAD at revision b883a790163947f6fc1fa51fe0d178629f83947b

Running "concat_in_order:your_target" (concat_in_order) task
File "thefragebogen.js" created.

Running "uglify:dist" (uglify) task
>> 1 file created 185.14 kB → 125.63 kB

Running "run:jsdoc" (run) task
ERROR: Unable to parse a tag's type expression for source file C:\Users\gabriel\Documents\Fragebogen\TheFragebogen\thefragebogen.js in line 3105 with tag title "param" and text "{string|array[string]} answer": Invalid type expression "string|array[string]": Expected "#", "$", "(", "-", ".", "/", "0", ":", "<", "=", "@", "[]", "\\", "\u200C", "\u200D", "_", "|", "~", Unicode combining mark, Unicode decimal number, Unicode letter number, Unicode lowercase letter, Unicode modifier letter, Unicode other letter, Unicode punctuation connector, Unicode titlecase letter, Unicode uppercase letter, [1-9] or end of input but "[" found.
ERROR: Unable to parse a tag's type expression for source file C:\Users\gabriel\Documents\Fragebogen\TheFragebogen\thefragebogen.js in line 3109 with tag title "param" and text "{string|array[string]} answer": Invalid type expression "string|array[string]": Expected "#", "$", "(", "-", ".", "/", "0", ":", "<", "=", "@", "[]", "\\", "\u200C", "\u200D", "_", "|", "~", Unicode combining mark, Unicode decimal number, Unicode letter number, Unicode lowercase letter, Unicode modifier letter, Unicode other letter, Unicode punctuation connector, Unicode titlecase letter, Unicode uppercase letter, [1-9] or end of input but "[" found.
Warning: non-zero exit code 1 Use --force to continue.

Aborted due to warnings.

[dennisguse]

Looks like jsdoc also changed some markup.
The most recent version can be found here: http://usejsdoc.org/tags-param.html
The two lines jsdoc complains about declare a param that can be of either string or an array of string.
Could you check if adjusting the syntax helps (tags-param.html CRTL-F for "Allows one type OR another type (type union)")?

[gabrielmittag]

It works with @param {(string|string[])} answer
Thanks!