#97 not generating any output

[Anonymous]

I'm trying to use NaturalDocs to generate documentation (portable, standard C++) open source project and it isn't generating any output. It also isn't giving me any diagnostics why it isn't generating any output. It says it's "Parsing 106 files...", it's creating some stuff under the -o directory, but there is no documentation being generated.

NaturalDocs needs better diagnostics, maybe a "verbose" mode in which it says a lot more about what it's doing and why it's doing.

Also, NaturalDocs should at the very least work correctly and generate a reasonable amount of documentation when pointed at a directory tree containing standard C/C++ code with a minimal command like:

naturaldocs -i sourcetree -o HTML docs -p docs-proj

I'm using 1.35 base, as shipping with Ubuntu.

[Greg Valure]

Have you written any comments in Natural Docs' format? C++ has basic language support which means it will not auto-document your code, it will only pick out the comments you have written specifically for it.

If you have written comments for Natural Docs, please post one here along with a couple of lines before and after it so I can see what's wrong.