After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 709803 - Generated hhc file contains an error for a section of a mainpage
Generated hhc file contains an error for a section of a mainpage
Status: RESOLVED FIXED
Product: doxygen
Classification: Other
Component: build
1.8.5
Other Windows
: Normal normal
: ---
Assigned To: Dimitri van Heesch
Dimitri van Heesch
Depends on:
Blocks:
 
 
Reported: 2013-10-10 10:31 UTC by stephan.vantienen
Modified: 2014-01-17 14:03 UTC
See Also:
GNOME target: ---
GNOME version: ---



Description stephan.vantienen 2013-10-10 10:31:14 UTC
When using a section within a mainpage as following:

/**
 * @mainpage My Main page
 * This is my main page.
 *
 * @section mysection My Section
 * This is my section.
 */

The configuration file has GENERATE_HTMLHELP set to YES. After running doxygen (1.8.5) the resulting index.hhc file contains an error:

<LI><OBJECT type="text/sitemap"><param name="Name" value="My Main page"><param name="Local" value="index.html"><param name="ImageNumber" value="11"></OBJECT>
  <UL>
  <LI><OBJECT type="text/sitemap"><param name="Name" value="My Section"><param name="Local" value="a00003.html#mysection"><param name="ImageNumber" value="1"></OBJECT>
  </UL>

The inner <LI> references "a00003.html#mysection" which should be "index.html#mysection".
This causes an error when running hhc.exe:

HHC5013: Error: URL reference in the TOC cannot be resolved: "a00003.html#mysection".

When changing the hhc file to use "index.html#mysection" it works correctly.

This construction worked fine with older versions of doxygen (not exactly sure when it started to fail). In the cases where it worked the section of the mainpage would not be part of the hhc file at all though.
Comment 1 Dimitri van Heesch 2013-10-12 11:43:57 UTC
I assume this only happens when SHORT_NAMES = YES ?
Comment 2 Dimitri van Heesch 2013-10-12 14:10:52 UTC
Confirmed. Should be fixed in the next GIT update.
Comment 3 stephan.vantienen 2013-10-14 05:52:22 UTC
Yes, you are correct: this happens with SHORT_NAMES = YES.

Thank you for the feedback.
Comment 4 Dimitri van Heesch 2013-12-24 18:59:28 UTC
This bug was previously marked ASSIGNED, which means it should be fixed in
doxygen version 1.8.6. Please verify if this is indeed the case. Reopen the
bug if you think it is not fixed and please include any additional information 
that you think can be relevant (preferrably in the form of a self-contained example).
Comment 5 stephan.vantienen 2014-01-17 14:03:16 UTC
Verified to be fixed in 1.8.6, thank you for the effort.