Clang doc

- Add -Wdocumentation for Debug mode in Clang: on recent clang (at least 4.2), clang will parse the doxygen method block and will generate warning if the "@param/@return" don't match with the method parameters.

- Various doxygen bug fixes