First step of comment style refactoring to doxygen-style.

The first step of a series of pull request documenting/updating the Doxygen syntax in the core.