(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
------------------------------------------------------------------------------
Site24x7 APM Insight: Get Deep Visibility into Application Performance
APM + Mobile APM + RUM: Monitor 3 App instances at just $35/Month
Monitor end-to-end web transactions and take corrective actions now
Troubleshoot faster and improve end-user experience. Signup Now!
http://pubads.g.doubleclick.net/gampad/clk?id=272487151&iu=/4140
_______________________________________________
Doxygen-users mailing list
Doxygen-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/doxygen-users
