Correct several doxygen tags (\file,...)

Cleaning doxygen warning such as 

- Correct several tags such as \file to make their argument point to the right file. 
- rename description to brief