Some cleanup of doxygen issues

simplify doxygen input path
reduce warnings from thousands to hundreds as long as major code is undocumented
fix displayed include paths in doxygen output
fix some of the warnings
It has nothing to do with MathJax. Before doxygen sees any of our files, we send them through doc/doxygen/scripts/filter which replaces $...$ by \f$...\f$.