Add additional JavaDoc

I did my best job to get all these correct, but I'd appreciate a second set of eyes to make sure that my comments are all correct.