Implemented Doxygen comments, should be reviewed by author @oda

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].


Former-commit-id: 8618f77c