Clarify javadocs