We believe the case for changing the formatting is self-evident. In summary the improvements are Return types and arguments are more easily identified. Function descriptions are bound more tightly to the functions they describe.
Grouped information is easier to identify.
We propose to split the summary listings from the descriptive text and split the descriptive text for each class into separate files. This allows us to produce summary only hardcopy and selective class hardcopy. The current output of cxx2html precludes these options. Implementing a user specified switch to display the private information should satisfy both classes of programmers.