Cleaned up comment style

Cleaned up some function definition comments to follow a more readable
JavaDoc like format in case I ever add automatic documentation.