Javadoc, code clarification