Corrected comments on header files in order to use doxygen to created
the documentation.