Details
-
Suggestion
-
Resolution: Invalid
-
P4: Low
-
None
-
6.7
-
None
Description
If I have an \annotatedlist groupName in one page, and then I have a bunch of other pages generated that are \ingroup groupName, I expect the "up" link (the rightmost link in the generated navigation bar) of a given \ingroup groupName page to go to the section/page that contains the \annotatedlist groupName.
Currently, that is true only if groupName is the same as the \group groupName in that .qdoc file. So as far as the navibar is concerned, a .qdoc file can have only 1 \annotatedlist.
If the names do not match, the navibar of each page \ingroup groupName is broken.
My use case is that I want to have multiple annotated lists for different groups of functions, for the squish-api.qdoc
The workaround I plan to use is to set the \previouspage to point to the parent document instead of worrying about the generated navigation bar.
The existence of an \annotatedlist groupName where groupName is not the same as the \group parentGroup of the same .qdoc file, qdoc should implicitly define a new group with that name, and get a title from the \sectionX header it is found in (or require another \title line?). There should be a child-parent link between groupName and parentGroup so that they both appear in the navibar of the generated \ingroup groupName pages as parent/grandparent.
Attachments
Issue Links
- relates to
-
QTBUG-128373 Generate \nextpage and \previouspage links for items in \annotatedlist
- Reported