Generating Doxygen docs hangs SourcePrefix.h

[Himanshu Gohel]

Attempting to regenerate the docs (particularly a PDF version) on WinXP using Doxygen 1.4.7 from the source for CPPUnit 1.12.0.

I used the command "doxygen -u" to update the provided Doxygen.in file from v1.1.4 to 1.4.7.

Next I manually edited all the variables like @top_srcdir@ etc. in the Doxygen.in file because I don't have make and friends on my WinXP PC.

Ran Doxygen on the resulting file and it runs through parsing, preprocessing and generating code.  However, when it gets to generating docs for SourcePrefix.h, it hangs indefinitely with somewhat low CPU usage.

All SourcePrefix.h does is include Portability.h, which doxygen successfully generated docs for...any ideas what is going on?

Thanks.

[Himanshu Gohel]

So I commented out the line:

#include <cppunit/Portability.h>

and doxygen 1.4.7 was able to finish the document generation in HTML.

Next step was to generate the LaTeX documentation, but when I ran LaTeX on the generated files, there were some errors in the LaTeX source.  This may be a doxygen issue rather than CPPUnit.

Is there a source for PDF version of the documentation?

[Himanshu Gohel]

With Doxygen 1.5.1-p1 the hang on processing SourcePrefix.h is no longer an issue, and I was able to complete the Doxygen run without errors.

There were several warnings arising from the usage of \link in Cookbook.dox, which turned out to be that Doxygen 1.5.1 doesn't seem to want the namespace in the link.  I converted all text like "\link CppUnit::<classname>" to simply "\link <classname>" and then the doxygen run seems to get rid of most warnings.

The remaining two warnings from Cookbook.dox are about two deprecated methods, which I didn't bother resolving.  Hope this helps the maintainers or anyone else trying to regenerate the PDF version of the docs.