Clarified javadocs Closes #609