Clarified javadocs