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

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

(Sorry for not trimming the previous posts, but I think it important to keep all the info together.)

Further debugging info: If I create a new top-level \section in the grouped \page, and then change all the original \section commands to \subsection, the issues are the same as before. That is, the issues seem more related to the page being a grouped page than issues with the \section or \subsection command.

My not-ideal workaround is going to be to abandon the grouping for the pages, which was a nice feature for having a parent group for both function groups and corresponding overview page groups. That is, I’ll just create a top-level (parent) page that has \subpage commands for all the overview pages.

This is still “grouping” of a sort, but by using the \subpage command inside a \page, instead of using \defgroup and \ingroup commands.

When I have time to create a standalone simple set of pages, I’ll file a bug in Bugzilla. But for now this workaround will do.

-Monique


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

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