Doxygen comments and consistent style

According to ATLAS Coding Guidelines comments are to follow the
Doxygen style commenting [doxygen-comments], written in complete
English sentences [english-comments]. In a header file comments
describing functions and attributes is to be included
[comment-functions].

According to ATLAS Coding Guidelines the style of each file
should be consistent with itself [style-consistency].