Documentation

Some javadoc comments with information I was missing while reading this code.