doxygen comments

[suchyta1]

The code should be documented better eventually. I might as well do this in doxygen format. This is lower priority than user documentation, but I don't want to push it back too much because I'd prefer to do it while I remember the code better.