GNOME Bugzilla – Bug 172787
Redundant namespace list in output from D code
Last modified: 2018-07-30 10:07:14 UTC
Please describe the problem: When generating documentation from D code, a 'Namespace List' page is generated. This does little but duplicates the content of the 'File List' page. There ought to be a way to get rid of this duplication. Steps to reproduce: Generate documentation from a set of D files. Actual results: A 'Namespace List' page is generated, listing the packages and modules. Since modules in D correspond directly to source files, this list is redundant with the 'File List' page. I aso tried it with the OPTIMIZE_OUTPUT_JAVA option set, and it makes little difference besides mentions of 'packages' rather than 'namesapces'. Expected results: Two proposed solutions. Idea 1: Have the 'Packages' page list only the packages (generally corresponding to folders), leaving 'File List' to list the modules. Individual package pages would list the subpackages and modules; the modules would link to the corresponding file pages. Idea 2: Have a single page listing packages and modules, and get rid of the 'File List' page. Of course, we'll need a means of getting documentation on the module pages - can we consider \package or \file adequate, or should we invent \module? Which of these approaches would be best? Moreover, would it be worth letting the user choose between the two? Does this happen every time? Yes Other information:
As discussed in https://github.com/doxygen/doxygen/pull/734 , Doxygen has moved its issue tracking to https://github.com/doxygen/doxygen/issues All Doxygen tickets in GNOME Bugzilla have been migrated to Github. You can subscribe and participate in the new ticket in Github. You can find the corresponding Github ticket by searching for its Bugzilla ID (number) in Github. Hence I am closing this GNOME Bugzilla ticket. Please use the corresponding ticket in Github instead. Thanks a lot!