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

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

Oh, an important point that I just thought to check: None of these bugs occur for pages that are not in a group.

I had non-grouped pages already, but they didn’t have any \section commands. So I just created a new test page with \sections, and it works as expected/correctly: the page appears in the nav tree independent of and after the Mainpage.

And as I alluded to below but didn’t quite state, the Mainpage includes \subpage commands for the non-grouped pages, and therefore when you expand the Mainpage, the nav tree shows those non-grouped pages.

I tried deleting the \subpage commands to see if that made a difference. What happened then is that those non-grouped pages now all appear at the top level of the nav-tree instead of under Mainpage, which is as expected.

But now what happens is that the last page can incorrectly/unexpectedly be expanded. When you expand it, those other pages’ \section titles now all appear (bug 2, below). And bug 1 as described below is still manifesting the same problem/appearance.

I hope this info helps isolate the issue,
-Monique


From: Monique Semp 
Sent: Friday, February 19, 2016 4:32 PM
To: doxygen-users 
Subject: [Doxygen-users] bugs? - section titles - in Mainpage nav tree,and in nav tree for the page

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