Implemented Doxygen comments

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

Comments are not complete, needs to be reviewed and made complete
at a later stage!