Comment clarification

Clarified a few things in the javadocs