Clean up doxygen syntax and reword comments to flow better, have a brief
section, and not have unfinished sentence fragments.