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
My previous comment about this seems to have disappeared. The word "put" was removed here, which made the sentence incomplete. If you can fix this, I think that the PR will be ready to merge.