[Doxygen-users] bugs? - section titles - in Mainpage nav tree, and in nav tree for the page

[Monique S. <mon...@ea...>]

Hello, Doxygen users,

I’m using Doxygen 1.8.10 on Windows 7, and seem to have hit a couple of bugs with how the pages’ \section titles appear in the left nav tree (with GENERATE_TREEVIEW = YES).

I’ve just added a bunch of \section commands to a bunch of \page files, where all the \page files are grouped under various Modules sub-groups (“Pages” and, for example, “Group-1”).

1. In the left nav tree under the Modules (well, under Modules > Pages > Group-1 > Each-Page), each page appears as expected.

But... the last section that’s listed for a page unexpectedly/incorrectly expands to show a repeat of all the section titles in the page. For example:

Pages
+--- Group-1
+--- +--- Page-1
+--- +--- +--- section-first
+--- +--- +--- ...
+--- +--- +--- section-last
+--- +--- +---  +--- section-first        <---- unexpected/incorrect repeat of all the page’s sections
+--- +--- +---  +--- ...
+--- +--- +---  +--- section-last

2. The second bug (?) is that every section name (in groups that are ordered alphabetically by the page name) is *unexpectedly* ALSO appearing in the left nav tree under the Mainpage’s Title, after the last expected (non-grouped) \page.

Before I added the section names, the tree under the Mainpage’s Title correctly showed only the non-grouped pages.

---
These issues both seem to be bugs, but perhaps I’ve misunderstood how the \section command should work? Or perhaps there’s some configuration setting I should be using?

I could replace the \section commands with just bold text, but then I’d lose the ability to use the \section titles as cross-references, which is the whole reason I added the \section commands. So perhaps there’s a better way to do that?

Thanks for your suggestions,
-Monique