Commenting/Documentation

It would be nice if we could get a wiki page set up for this library. I know GitHub supports wikis and we could link to it in our comments if we had one.

Also (and this is mostly my fault since I have written most of the code), the code is not well commented, so that needs fixing too.