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 for directories that do not contain any input files
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
fixes Doxygen erroneously including non-type keywords like friend as part of a function's return type
fixes most situations where Doxygen has buthered trailing return types
reformats the XML to be formatted consistently from one version to the next

to-do. it does a lot!