code remarks cleanup and doxygen: #21
Merge pull request #26 from ahebert/master

code remarks cleanup and doxygen: #21