Fixes some doxygen errors/warnings (by use of dummy descriptions)
Makes silencing of doxygen optional
Enables an option to build an extended documentation where doxygen is instructed to automatically include undocumented code and build call and caller graphs
Adds documentation about the cmake variables controlling doxygen
This pull-request