Add a YouCompleteMe configuration

See http://valloric.github.io/YouCompleteMe/ for more details
Fix the errors reported by Doxygen

No code changes, just adjustments in the documentation. The generated
documentation is not complete yet, though.