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
I don't think we need the \f here. Just replace it with $M$.