Clean up doxygen syntax and reword comments to flow better, have a brief