Search code examples
doxygenchm

chm help file generated by doxygen can't display its content


chm file generated by doxygen displays incorrectly.

See this pic:

I'm trying to compile a chm help file using doxygen, all the html files were generated without any problem. The chm file was generated too (even though there is an error message "failed to run html help compiler on index.hhp" in the doxygen output logs, but the file size of this chm file seems to be normal) but when I open it, the help file viewer just shows

"Can’t reach this page Make sure the web address //ieframe.dll/dnserrordiagoff.htm# is correct ..."

Here are the related doxygen configs I used:

GENERATE_HTMLHELP      = YES

HHC_LOCATION           = "C:\Program Files (x86)\HTML Help Workshop\hhc.exe"

and my doxygen version is 1.9.6

What are the possible reasons?


Solution

  • After investigation of my source code, I located the cause of this issue:

    a function definition (with too many parameters) in a .h file is too long. Things goes away after I reduced the length of the parameter list of this function.

    According to the information from @Albert, the latest doxygen release 1.9.7 at May 19 fixed this issue, and I did a check using this version, it did work.