I'm trying to use Doxygen for documenting some API written in C#, but I find the flow of the information in the generated pages needlessly fragmented. All the methods with brief descriptions are listed first, and then they are listed again underneath with more detailed descriptions.
What's the point of this when the details could be shown inline with foldouts? Doxygen already use foldouts extensively in the sidebar when GENERATE_TREEVIEW is set to YES, so clearly supports the concept of content revealed and hidden via foldouts.
This image illustrates what I'm looking for:
I've looked quite a bit for an answer for whether this can be achieved with special settings or custom CSS without outright modifying the Doxygen source, but haven't been able to find out anything about it.
Another way to describe the issue: Doxygen generates class pages like this:
- Brief class description.
- Brief member A description
- Brief member B description
- Brief member C description
- Detailed class description.
- Detailed member A description
- Detailed member B description
- Detailed member C description
Whereas I want
- Brief class description.
- Detailed class description (foldout).
- Brief member A description
- Detailed member A description (foldout).
- Brief member B description
- Detailed member B description (foldout).
- Brief member C description
- Detailed member C description (foldout).
The detailed ones would of course not need to repeat any info already in the brief descriptions here, as the brief description of each member would be immediately above the detailed one.
I have investigated the configuration options and the DoxygenLayout.xml file, and none of those provide mechanisms for this. For example, the xml file contains an entry like this:
<memberdecl>
...
<publicmethods title=""/>
But this generates ALL the public methods brief descriptions at once, without any possibility of inserting extra info for each of them.