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
