Fixes and Improvements provided by Poxy

This page is a summary of all the fixes and improvements Poxy provides over the stock combo of Doxygen + m.css.

Doxygen XML

• removes dir_XXXX.xml entries that do not contain any inner file/directory descriptions
• removes empty file_XXXX.xml entries that only exist to describe a documentation-only file (e.g. .dox files)
  • note: this does not remove the contents of these files from the documentation; only their useless listings in the "Files" page
• removes local file paths from generated tagfiles (they don't serve any purpose other than being a privacy breach)
• removes duplicate <memberdef> tags erroneously generated by some versions of doxygen when using multiple groups
• merges user-specified class member @name groups with the same name (so you do not need to rearrange code to make Doxygen behave)
• merges documentation from file_XXXX.xml files for 'implementation' headers into that of their corresponding public header (per config option implementation_headers)
• sorts user-defined class member @name groups alphabetically
• sorts <memberdef> tags alphabetically
  • note: this does not include non-static class/struct/union member variables; these stay in declaration order!
• sorts <inner(class|namespace|group)>` tags alphabetically
• adds missing inline="yes" attributes to namespaces when specified using the inline_namespaces config option

m.css HTML

to-do. it does a lot!